@kitepass/mcp-server

Model Context Protocol server for Kite Agent Passport. Give Claude, GPT, or any MCP-aware LLM the ability to authenticate, manage sessions, and execute x402 payments on Kite Mainnet.

What this is

KitePass MCP Server is an open-source implementation of an MCP server that bridges LLM agents with Kite's agent payment infrastructure. It wraps the kpass CLI operations as callable MCP tools, enabling any MCP-aware AI assistant to:

• Check wallet balances on Kite Mainnet

• Create and manage agent spending sessions

• Execute x402 micropayments to paid APIs

• List registered agents and their status

This is a community-built project, not officially endorsed by Anthropic or the Kite Foundation.

Related MCP server: hmpo-mcp-server-practice

Quick start

1. Install

npm install -g @kitepass/mcp-server

2. Prerequisites

• Node 18+

• kpass CLI installed and logged in

  kpass login --email your@email.com
  kpass me  # should show your user info

3. Configure Claude Desktop

Add to your Claude Desktop config file:

{
  "mcpServers": {
    "kitepass": {
      "command": "npx",
      "args": ["@kitepass/mcp-server"]
    }
  }
}

4. Restart Claude Desktop

You can now ask Claude:

• "What's my Kite wallet balance?"

• "Show me my active sessions"

• "Create a $0.01 session for one hour"

• "List the agents I have registered"

Available tools

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐     ┌────────────────┐
│  Claude Desktop │────▶│  KitePass MCP    │────▶│  kpass CLI      │────▶│  Kite Passport │
│  (MCP Client)   │◀────│  Server          │◀────│  (subprocess)   │◀────│  Backend       │
└─────────────────┘     └──────────────────┘     └─────────────────┘     └────────────────┘

The MCP server runs as a local subprocess of Claude Desktop. Each tool call spawns a fresh kpass subprocess, executes the operation, and returns the result. No long-running processes or state is maintained between calls.

Security model

• Identity: The MCP server runs with the user's kpass identity. All operations are performed as the logged-in user.

• Write operations: Creating sessions and executing payments require an approved session. The approval URL must be opened by the human user — the AI cannot approve sessions itself.

• No token exposure: JWT tokens and session secrets are never included in tool outputs. Error messages are sanitized.

• URL validation: Payment execution refuses non-HTTPS URLs, localhost, and local network addresses.

• Timeout protection: All operations have timeouts (30s default, 5min max for payments).

Configuration

Examples

See the examples/ directory for:

• claude-desktop.json — Claude Desktop configuration

• basic-agent.ts — Using MCP from a custom agent

• payment-flow.ts — End-to-end payment example

Development

git clone https://github.com/gnanam1990/kitepass-mcp
cd kitepass-mcp
npm install
npm run build
npm test

Roadmap

• v0.1: 8 read/write tools, stdio transport, Claude Desktop integration (current)

• v0.2: HTTP transport, observability tools, batch operations

• v0.3: Multi-user / hosted mode

Contributing

Issues and PRs welcome. Please run npm test before submitting.

Credits

Built by Gnanam (@0x_art).

Thanks to the Kite Foundation and Anthropic teams for the foundational tooling.

License

MIT