Manage integrations in console

    Connect to the Google Pay & Wallet Developer MCP server

    The Google Pay & Wallet Developer MCP server gives AI-powered development tools the ability to access your Google Pay and Google Wallet developer data, search official documentation, and manage your integrations.

    Model Context Protocol (MCP) standardizes how large language models (LLMs) and AI applications or agents connect to outside data sources. MCP servers let you use their tools, resources, and prompts to take actions and get updated data from their backend service.

    The Google Pay & Wallet Developer MCP server lets you:

    • Search documentation: Get up-to-date guidance and code samples from official Google Pay and Google Wallet docs.
    • Manage integrations: Check the status of your integrations and enable APIs for your merchant account.
    • Monitor performance: Access aggregated performance data and error metrics for your merchant account.

    • Manage passes: List pass issuers and classes for Google Wallet.

    Sample prompts

    You can use the following prompts with your AI assistant:

    • "List my Google Pay accounts."
    • "What is the status of my Google Pay integrations?"
    • "How can I integrate Google Pay with React?"
    • "Show me Google Pay error metrics for my integration over the last 30 days."
    • "List my Google Wallet pass classes."

    Before you begin

    To use the Google Pay & Wallet Developer MCP server, you must create a Google Cloud project and enable the Google Pay & Wallet Developer MCP server and Google Wallet APIs.

    1. In your Cloud console, on the project selector page, select or create a Google Cloud project.

      Go to project selector

    2. Enable the Pay & Wallet Developer, Google Wallet APIs.

      Roles required to enable APIs

      To enable APIs, you need the Service Usage Admin IAM role ( roles/serviceusage.serviceUsageAdmin ), which contains the serviceusage.services.enable permission. Learn how to grant roles .

      Enable the APIs

    Required roles

    To get the permissions that you need to use the Google Pay & Wallet Developer MCP server remote MCP server, ask your administrator to grant you the following Identity and Access Management (IAM) roles on the Google Cloud project where you want to enable the Google Pay & Wallet Developer MCP server MCP server:

    For more information about granting roles, see Manage access to projects, folders, and organizations .

    Authentication and authorization

    Google Pay & Wallet Developer MCP server MCP servers use the OAuth 2.0 protocol with Identity and Access Management (IAM) for authentication and authorization. All identities are supported for authentication to MCP servers.

    The Google Pay & Wallet Developer MCP server does not accept API keys.

    We recommend creating a separate identity for agents using MCP tools so that access to resources can be controlled and monitored. For more information on authentication, see Authenticate to MCP servers .

    Google Pay & Wallet Developer MCP server OAuth scopes

    OAuth 2.0 uses scopes and credentials to determine if an authenticated principal is authorized to take a specific action on a resource. For more information about OAuth 2.0 scopes at Google, read Using OAuth 2.0 to access Google APIs .

    Google Pay & Wallet Developer MCP server has the following MCP tool OAuth scopes:

    Scope URI for gcloud CLI Description
    https://www.googleapis.com/auth/paydeveloper.merchant Manage Google Pay merchant data.
    https://www.googleapis.com/auth/paydeveloper.issuer.readonly Read Google Wallet issuer data.

    Create an OAuth 2.0 client ID and secret

    To create an OAuth 2.0 client ID and secret, follow these steps:

    1. In the Google API Console, go to Google Auth Platform > Clients > Create client .

      Go to Create client

    2. In the Application type list, select the appropriate type for your AI application:

      • For Antigravity , Claude.ai , Claude Code , and ChatGPT , select Web application .
      • For Gemini CLI and VS Code , select Desktop app .

    3. In the Name field, enter a name for your application.

    4. If you selected Web application , in the Authorized redirect URIs section, click + Add URI , and then add the required redirect URI for your AI application:

      Antigravity

      https://antigravity.google/oauth-callback

      Claude.ai

      https://claude.ai/api/mcp/auth_callback

      Claude Code

      http://localhost: CLAUDE_REDIRECT_PORT 
/callback

      ChatGPT

      You can leave the redirect_uri blank for now. ChatGPT generates a redirect_uri when the app is created (see Configure your AI application below).

    5. Click Create . Upon creation, the client secret is displayed once. Copy it and store it securely.

    Configure your AI application

    Next, you need to provide your AI application with the server configuration details.

    Gemini CLI

    1. To configure Gemini CLI , add the following to your `~/.gemini/settings.json` file:

       { 
  
 "mcpServers" 
 : 
  
 { 
  
 " google-pay-wallet-dev 
" 
 : 
  
 { 
  
 "httpUrl" 
 : 
  
 "https://paydeveloper.googleapis.com/mcp" 
 , 
  
 "authProviderType" 
 : 
  
 "dynamic_discovery" 
 , 
  
 "oauth" 
 : 
  
 { 
  
 "enabled" 
 : 
  
 true 
 , 
  
 "clientId" 
 : 
  
 " GEMINI_CLI_CLIENT_ID 
" 
 , 
  
 "clientSecret" 
 : 
  
 " GEMINI_CLI_CLIENT_SECRET 
" 
 , 
  
 "scopes" 
 : 
  
 [ 
  
 "https://www.googleapis.com/auth/paydeveloper.merchant" 
 , 
  
 "https://www.googleapis.com/auth/paydeveloper.issuer.readonly" 
  
 ] 
  
 } 
  
 } 
  
 } 
 }

    2. Run /mcp auth google-pay-wallet-dev to initiate the authentication process for the Google Pay & Wallet Developer MCP server.

    Antigravity

    To configure Antigravity to use the MCP server:

    1. In Antigravity, click the Additional options menu in the Agent pane > MCP Servers > Manage MCP Servers .
    2. At the top of the Manage MCP Servers pane, click View raw config to edit the mcp_config.json file: 
       { 
  
 "mcpServers" 
 : 
  
 { 
  
 " google-pay-wallet-dev 
" 
 : 
  
 { 
  
 "serverUrl" 
 : 
  
 "https://paydeveloper.googleapis.com/mcp" 
 , 
  
 "oauth" 
 : 
  
 { 
  
 "clientId" 
 : 
  
 " ANTIGRAVITY_CLIENT_ID 
" 
 , 
  
 "clientSecret" 
 : 
  
 " ANTIGRAVITY_CLIENT_SECRET 
" 
  
 } 
  
 } 
  
 } 
 }
    3. Return to Manage MCP servers and click Refresh . Clicking on Authenticate opens the Customizations tab in Agent Settings .
    4. Click Authenticate and complete the OAuth flow.
    5. Copy the authorization code and submit the code in the Agent Settings window.

    VS Code

    1. To configure VS Code (Copilot), edit the .vscode/mcp.json file in your workspace: 
       { 
  
 "servers" 
 : 
  
 { 
  
 " google-pay-wallet-dev 
" 
 : 
  
 { 
  
 "url" 
 : 
  
 "https://paydeveloper.googleapis.com/mcp" 
  
 } 
  
 } 
 }
    2. Call a tool in the MCP server to trigger the authentication process. For example: "List my Google Pay accounts".
    3. The Dynamic Client Registration not supported dialog opens as expected. Click any button to close the dialog.
    4. Enter your OAuth client ID and press enter.
    5. When prompted, enter your OAuth client secret and press enter.
    6. A dialog to authenticate opens, click Allow .
    7. After authorizing, the tool is called and the session continues in the chat window.

    Claude.ai

    To configure Claude.ai:

    1. Navigate to Customize > Connectors .
    2. Click the button and choose Add custom connector .
    3. Enter the following details:
        Server name : Google Pay & Wallet MCP .
        Remote MCP server URL https://paydeveloper.googleapis.com/mcp .
    4. In Advanced settings enter your OAuth client ID and OAuth client secret .
    5. Select the new connector and click Connect .

    Claude Code

    To configure Claude Code, run the following command:

     MCP_CLIENT_SECRET 
 = 
 CLAUDE_CODE_CLIENT_SECRET 
  
claude  
mcp  
add  
--transport  
http  
 \ 
  
--client-id  
 CLAUDE_CODE_CLIENT_ID 
  
--client-secret  
--callback-port  
 CLAUDE_REDIRECT_PORT 
  
 \ 
  
 google-pay-wallet-dev 
  
https://paydeveloper.googleapis.com/mcp

    ChatGPT

    To configure ChatGPT:

    1. Enable Developer mode from Settings > Apps > Advanced settings .
    2. Click the Create app button.
    3. Enter the following details:
        Name : Google Pay & Wallet MCP .
        MCP server URL : https://paydeveloper.googleapis.com/mcp
    4. Go to Advanced settings and enter your OAuth client ID and secret.
    5. Copy the dynamic callback URL and add it to the OAuth client created in the previous step.

    Known limitations

    • English-only results: Documentation search only supports English.
    • Content behind ACL: Documentation behind ACLs is not indexed
    • Network-dependent: The server requires a live connection to Google Pay and Wallet services.

    Terms of Service

    Use of the Google Pay API is subject to the Google Pay API Terms of Service . Use of the Google Wallet API is subject to the Google Wallet API Terms of Service .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: