Skip to main content
Glama

@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: ibronevik-taxi-mcp

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:

OS

Path

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

{
  "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

Tool

Description

Type

kpass_get_user

Current logged-in user info

Read

kpass_list_sessions

Active/pending/expired agent sessions

Read

kpass_get_wallet_balance

KITE + USDC.e balance

Read

kpass_health_check

Kite Passport backend health

Read

kpass_create_session

Create spending session (returns approval URL)

Write

kpass_check_session_status

Poll session approval state

Read

kpass_execute_payment

Execute x402 payment via approved session

Write

kpass_list_agents

List registered agents

Read

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

Env var

Default

Purpose

KPASS_BINARY_PATH

(PATH lookup)

Override kpass binary location

KITE_PASSPORT_BASE_URL

https://passport.prod.gokite.ai

Override Kite Passport backend URL

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes read-only tools to query a passport applications database, enabling an AI assistant to check application status without exposing personal applicant details.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables language models to interact with a taxi service backend through MCP tools, providing read-only access to reference data and authentication status.
      4
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables authenticated access to a Zerodha trading account by exposing brokerage REST operations and live WebSocket ticker controls as MCP tools, covering orders, portfolio, market data, margins, GTT, mutual funds, and session management. It also batches tool-call audit records to SQLite.
      MIT