@codespar/mcp

@codespar/mcp

MCP server for CodeSpar — give Claude, Codex, Cursor, VS Code (and any MCP client) a Latin-American commerce agent: search & checkout, Pix, wallet/balance, spend mandates & limits, and Pomelo card issuing — all as MCP tools.

Run as a server (codespar-mcp)

A stdio MCP server that bridges your MCP client to a CodeSpar session's tools. It talks to the CodeSpar REST API directly, so it works against the live meta-tools today (codespar_pay, codespar_charge, codespar_discover, wallet, mandates, and codespar_issue → Pomelo card). One env var (CODESPAR_API_KEY) and you're in.

Claude Code / Claude Desktop

claude mcp add codespar -- npx -y @codespar/mcp
# then set CODESPAR_API_KEY in the server's env

Codex — ~/.codex/config.toml:

[mcp_servers.codespar]
command = "npx"
args = ["-y", "@codespar/mcp"]
env = { CODESPAR_API_KEY = "csk_live_...", CODESPAR_PRESET = "brazilian" }

Cursor / VS Code — { "command": "npx", "args": ["-y", "@codespar/mcp"], "env": { "CODESPAR_API_KEY": "csk_live_..." } }

Config (env or --flag): CODESPAR_API_KEY (required), CODESPAR_PROJECT (prj_…), CODESPAR_PRESET (brazilian|mexican|argentinian|colombian|all, default brazilian), CODESPAR_SERVERS (comma list, overrides preset), CODESPAR_USER_ID.

Use as a config helper (library)

npm install @codespar/mcp @codespar/sdk

Usage

import { CodeSpar } from "@codespar/sdk";
import { getMcpConfig, getClaudeDesktopConfig } from "@codespar/mcp";

const cs = new CodeSpar({ apiKey: "ak_..." });
// Optionally pin to a project: new CodeSpar({ apiKey: "ak_...", projectId: "prj_..." })
const session = await cs.create("user_123", { preset: "brazilian" });

// Get MCP URL and headers for any client
const { url, headers } = getMcpConfig(session);

// Get Claude Desktop config JSON
const config = getClaudeDesktopConfig(session);

The session itself also exposes the meta-tool router wrappers — session.discover(query), session.connectionWizard({...}), session.paymentStatus(toolCallId) — for tool search, connect deep-links, and async settlement correlation.

API

Function	Signature	Description
getMcpConfig	(session: Session) => McpConfig	Get the MCP transport URL and headers for any MCP-compatible client
getClaudeDesktopConfig	(session: Session, serverName?: string) => { mcpServers: ... }	Generate Claude Desktop configuration (for claude_desktop_config.json)
getCursorConfig	(session: Session) => { url: string; headers: Record<string, string> }	Generate Cursor / VS Code MCP configuration

McpConfig

Property	Type	Description
url	string	MCP transport URL
headers	Record<string, string>	Auth headers for the transport

Need more?

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT — codespar.dev