@codespar/mcp

@codespar/mcp

MCP transport for CodeSpar — connect Claude Desktop, Cursor, VS Code, and other MCP clients to CodeSpar sessions.

Install

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 F3.M2 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