Agentic

MCP Integration

Copy page

The Tesser MCP server exposes every public API endpoint as a tool that AI agents can discover and invoke. It uses Streamable HTTP transport at:

Code
 
https://sandbox.tesserx.co/v1/mcp

Authentication uses the same OAuth 2.0 Bearer token as the REST API. See Resources for how to obtain a token.

Claude Code

1. Set your token in the shell before launching Claude Code:

Code
 
export MCP_TOKEN=$(bash scripts/mcp-token.sh)

2. Add the config to .claude/settings.local.json in your project root:

Code
 
{
  "mcpServers": {
    "tesser-payments": {
      "type": "url",
      "url": "https://sandbox.tesserx.co/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_TOKEN}"
      }
    }
  }
}

3. Activate by running /mcp in your Claude Code session to reload MCP servers. Tesser tools will appear immediately.

Cursor

1. Set your token in the shell before launching Cursor:

Code
 
export MCP_TOKEN=$(bash scripts/mcp-token.sh)

2. Add the config to .cursor/mcp.json in your project root:

Code
 
{
  "mcpServers": {
    "tesser-payments": {
      "type": "url",
      "url": "https://sandbox.tesserx.co/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_TOKEN}"
      }
    }
  }
}

3. Activate by restarting Cursor. Tesser tools will appear in the MCP tools panel.

Windsurf

1. Set your token in the shell before launching Windsurf:

Code
 
export MCP_TOKEN=$(bash scripts/mcp-token.sh)

2. Add the config to .windsurf/mcp.json in your project root:

Code
 
{
  "mcpServers": {
    "tesser-payments": {
      "type": "url",
      "url": "https://sandbox.tesserx.co/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_TOKEN}"
      }
    }
  }
}

3. Activate by restarting Windsurf.

Token Refresh

Tokens expire after approximately 24 hours. When they expire, MCP tool calls will fail with a 401 error. To refresh:

1. Run export MCP_TOKEN=$(bash scripts/mcp-token.sh) in your shell
2. Restart your IDE (or run /mcp in Claude Code)

For details on the token script and manual token management, see Manual MCP Setup.