Developer resources
Set up your environment, pick a client, and learn the platform pieces you build against.
Developer resources
Set up your environment, pick a client, and learn the platform pieces you build against.
Everything on this page is a destination, not an explanation. If you are looking for how the system fits together, How CodeSpar works is the page for that.
Essentials
SDK
The TypeScript client for the fifteen meta-tools and the money paths, plus the session model everything else builds on.
CLI
Drive the same operations from a terminal. Useful for the first call and for anything you would otherwise script by hand.
API reference
Every operation the published OpenAPI document describes, one page per resource, each runnable from the page itself.
Hosted MCP server
One URL gives Claude Code, Claude Desktop, Cursor, Windsurf or any other client the 15 meta-tools, without writing HTTP or installing anything.
@codespar/mcp (local)
The same server as a stdio process, for clients that spawn one: install, setup mode, config helpers, troubleshooting.
Framework adapters
langchain, crewai, vercel, openai, llama-index, mastra, autogen, camel, letta and google-genai, exposing the same tools.
Test mode
The csk_test_ prefix picks the environment, not the host. What is real in sandbox and what is not.
Machine-readable contracts
The documents an agent fetches without asking a person. Each is served without a credential.
OpenAPI document
The contract itself, at api.codespar.dev/openapi.json. Generate a client from it instead of reading pages.
Types package
@codespar/api-types: the shapes the runtime validates against, published to npm.
Tool calls over HTTP
Calling a meta-tool without the SDK, when your runtime is not TypeScript.
Tools
Agent-Ready check
Score any site on what an agent can discover about it. The same scanner we run against ourselves.
MCP generator
Point it at an API and get an MCP server. Scans the surface, builds the tools, and hands you something to run.
Build your own
Publish a server into the catalog so other people's agents can find and call it.
Server catalogue
What is already connectable, by category and country, with its authentication shape.
Reliability and debugging
Debugging
What to do when a call does not do what you expected, and which identifier to quote.
Error reference
The refusal codes, what each one means, and which are worth retrying.
Triggers
Subscribe to events instead of polling. Deliveries, dead letters and redelivery.
Webhooks
Receiving provider events, and how they reach your endpoint.
Security and governance
Authentication
Keys, scopes and OAuth 2.1. What a key can reach, and how the environment is chosen.
Guardrails
Signed mandates with a cap and an expiry. A call that would exceed one is refused before money moves.
Agent identity
Who an agent is, and what that claim is worth to the other side.
Audit chain
The append-only record of what was spent under which mandate, and how to verify it.
Versioning
Facilitator
Ingest an externally-signed x402 (EIP-3009) authorization, verify it, translate it onto an internal mandate, execute it under the cap gate, and seal a receipt.
Error Reference
Every error code the CodeSpar API can return, with HTTP status, the response shape, when it fires, and the fix. Aggregated across sessions, projects, connections, triggers, wallets, and auth surfaces.