Connection

MCP server connection, install instructions, and protocol reference.

Streamable HTTP Endpoint#

Connect directly to the cloud MCP endpoint. No install needed -- all tools run remotely.

Endpoint:

https://api.agentpmt.com/mcp

Transport: Streamable HTTP (JSON-RPC over HTTPS)

Authentication: Bearer token from your AgentPMT dashboard.

Get your Bearer token

Go to your Dashboard and click Display Bearer Token to copy it.

Configure your MCP client

Point your MCP client at the endpoint with your token as the Authorization: Bearer header. Example for clients that support HTTP transport:

{
  "mcpServers": {
    "agentpmt": {
      "url": "https://api.agentpmt.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Start using tools

Your AI agent now has access to all AgentPMT tools in your budget. No restarts needed when tools change -- the catalog refreshes automatically.

Local Install (STDIO / SSE)#

Install a lightweight local connector for platforms that use STDIO transport. The local binary forwards JSON-RPC calls to the cloud endpoint over HTTPS.

Prerequisites#

Node.js (v18+) with npm. Check with npm --version. Download from nodejs.org if needed.
Bearer token from your Dashboard (click Display Bearer Token).

Install the MCP Router

npm install -g @agentpmt/mcp-router

This downloads the universal MCP server package and the platform-appropriate router binary.

Run the Setup Wizard

agentpmt-setup

The wizard will:

Auto-detect all installed AI tools on your system
Prompt for your Bearer token
Automatically configure all detected platforms

Restart Your AI Tools

Close and reopen your AI tools. AgentPMT tools will appear in the available tools list.

Some platforms (like Claude Desktop) may require 2-3 restarts to load MCP servers.

Manual Configuration#

If the wizard didn't detect your platform, or you need custom configuration, add the config manually.

Config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agentpmt": {
      "command": "npx",
      "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
      "env": {
        "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Config file: ~/.claude.json (all platforms)

{
  "mcpServers": {
    "agentpmt": {
      "command": "npx",
      "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
      "env": {
        "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Config file: ~/.cursor/mcp.json (all platforms)

{
  "mcpServers": {
    "agentpmt": {
      "command": "npx",
      "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
      "env": {
        "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

After adding: Open Cursor Settings > Features > MCP and click Refresh.

Config file:

Windows: %APPDATA%\Code\User\mcp.json
macOS: ~/Library/Application Support/Code/User/mcp.json
Linux: ~/.config/Code/User/mcp.json

{
  "mcpServers": {
    "agentpmt": {
      "command": "npx",
      "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
      "env": {
        "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Config file: ~/.codeium/windsurf/mcp_config.json (all platforms)

{
  "mcpServers": {
    "agentpmt": {
      "command": "npx",
      "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
      "env": {
        "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Config file:

Windows: %APPDATA%\Zed\settings.json
macOS/Linux: ~/.config/zed/settings.json

{
  "context_servers": {
    "agentpmt": {
      "settings": {},
      "command": {
        "path": "npx",
        "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
        "env": {
          "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
        }
      }
    }
  }
}

Config file: ~/.codex/config.toml (all platforms)

[mcp_servers.agentpmt]
command = "npx"
args = ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"]

[mcp_servers.agentpmt.env]
AGENTPMT_BEARER_TOKEN = "YOUR_TOKEN"

Config file: ~/.gemini/settings.json (all platforms)

{
  "mcpServers": {
    "agentpmt": {
      "command": "npx",
      "args": ["--package=@agentpmt/mcp-router@latest", "agentpmt-router"],
      "env": {
        "AGENTPMT_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

How It Works#

The local router is a lightweight STDIO connector. It does not execute tools locally.

Your AI tool sends JSON-RPC messages via STDIO to the local binary.
The binary forwards them over HTTPS to https://api.agentpmt.com/mcp using your Bearer token.
All tool execution happens on AgentPMT's cloud infrastructure.
The tool catalog auto-refreshes every 30 minutes -- new tools appear without restarts.
Every tool call is logged with a full audit trail visible in your dashboard.

Discovery and Protocol Reference#

MCP Endpoint

https://api.agentpmt.com/mcp

Native MCP Methods

These protocol methods are natively available for authenticated MCP clients.

Method	What it does
`initialize`	Negotiates MCP protocol capabilities and starts a session.
`notifications/initialized`	Confirms client initialization after a successful initialize call.
`tools/list`	Returns the currently available native tool set for the authenticated context.
`tools/call`	Invokes a selected native tool by name with tool-specific arguments.

Fetch Native Tools And Call Them

Use tools/list to see your current native MCP tools, then call one with tools/call.

1) Initialize

curl -X POST "https://api.agentpmt.com/mcp" \
  -H "Authorization: Bearer <oauth_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "clientInfo": {
      "name": "agentpmt-docs-example-client",
      "version": "1.0.0"
    },
    "capabilities": {
      "tools": {}
    }
  }
}'

2) List current native tools

curl -X POST "https://api.agentpmt.com/mcp" \
  -H "Authorization: Bearer <oauth_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}'

3) Call a tool returned by tools/list

curl -X POST "https://api.agentpmt.com/mcp" \
  -H "Authorization: Bearer <oauth_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "<tool_name_from_tools_list>",
    "arguments": {
      "example_input": "value"
    }
  }
}'

Get More Tools

Discover additional tools from the external catalog, then invoke them. After enabling tools, reconnect MCP and run tools/list again to refresh your native list.

1) Browse available external tools

curl -X GET "https://www.agentpmt.com/api/external/tools?limit=20"

2) Create an auth session for wallet signing

curl -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET"
  }'

3) Invoke a selected tool

curl -X POST "https://www.agentpmt.com/api/external/tools/<product_id>/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "<unique_request_id>",
    "signature": "0x<wallet_signature>",
    "parameters": {
      "example": "value"
    }
  }'

Well-Known Discovery URLs

https://api.agentpmt.com/.well-known/oauth-authorization-server
https://api.agentpmt.com/.well-known/oauth-protected-resource
https://api.agentpmt.com/.well-known/openai-apps-challenge
https://api.agentpmt.com/.well-known/openid-configuration
https://www.agentpmt.com/.well-known/agent-card.json
https://www.agentpmt.com/.well-known/agent.json
https://www.agentpmt.com/.well-known/mcp
https://www.agentpmt.com/.well-known/mcp/server-card.json
https://www.agentpmt.com/.well-known/mcp/server.json

OAuth

https://api.agentpmt.com/oauth/authorize
https://api.agentpmt.com/oauth/jwks.json
https://api.agentpmt.com/oauth/register
https://api.agentpmt.com/oauth/token

Autonomous Agents#

If you are building an autonomous agent that needs to access tools programmatically without MCP, see the Autonomous Agents API Reference for wallet-authenticated endpoints covering identity, purchasing, tool calls, and jobs.