MCP Server
8 native payment tools for Claude Desktop, Cursor, and any MCP-compatible agent. Supports stdio and Streamable HTTP transports.
Claude Desktop Setup
Get an API key
Register at skalor.xyz/developer/keys or use the skalor_register_agent tool after connecting (it creates a key for you).
Add to Claude Desktop config
Edit ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"skalor": {
"command": "npx",
"args": ["skalor-mcp-server"],
"env": {
"SKALOR_API_KEY": "zc_your_key_here"
}
}
}
}Restart Claude Desktop
Restart the app. You should see 8 Skalor tools available in the tools menu. Try asking Claude: "Check my Skalor budget"
Cursor Setup
Same config, different file. Add to your Cursor MCP settings:
{
"mcpServers": {
"skalor": {
"command": "npx",
"args": ["skalor-mcp-server"],
"env": {
"SKALOR_API_KEY": "zc_your_key_here"
}
}
}
}Streamable HTTP Mode
For remote agents, production deployments, or any HTTP-based MCP client:
# Default port 8402
npx skalor-mcp-server --http
# Custom port
npx skalor-mcp-server --http --port 9000POST /mcpMCP endpoint (Streamable HTTP)GET /healthHealth check endpoint8 Tools
| Tool | Description |
|---|---|
skalor_authorize_payment | Clear 5 fiduciary gates and authorize a payment |
skalor_check_budget | Query remaining budget, limits, and daily spend |
skalor_get_mandate | Full mandate details (all 5 gate configs) |
skalor_list_transactions | Audit trail with filters (all/approved/denied) |
skalor_register_agent | Self-service agent registration (returns API key) |
skalor_transfer | A2A agent-to-agent payment via Tempo |
skalor_create_api_key | Generate a new API key for sub-agents |
skalor_discover | Service discovery - pricing, networks, SDKs |
Example Conversation
You
"Check my Skalor budget"
Claude (calls skalor_check_budget)
Your agent "Research Assistant" has $7.50 remaining of a $10.00 daily budget. Your max single payment is $1.00. Budget resets at midnight UTC.
You
"Authorize $0.50 to api.openai.com for GPT-4o inference for my research project"
Claude (calls skalor_authorize_payment)
CLEARED: $0.50 to api.openai.com. All 5 fiduciary gates passed. Transaction ID: a1b2c3d4. Remaining budget: $7.00.
Environment Variables
| Variable | Required | Description |
|---|---|---|
SKALOR_API_KEY | For auth tools | Your zc_... API key |
SUPABASE_URL | Auto | Supabase project URL (pre-configured) |
SUPABASE_SERVICE_ROLE_KEY | Auto | Service role key (pre-configured) |