---
title: Developer resources
description: Set up your environment, pick a client, and learn the platform pieces you build against.
---

import { Cards, Card } from "fumadocs-ui/components/card";

# 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](/docs/how-it-works) is the page for that.

## Essentials

<Cards>
  <Card
    title="SDK"
    href="/docs/api/sdk"
    description="The TypeScript client for the fifteen meta-tools and the money paths, plus the session model everything else builds on."
  />
  <Card
    title="CLI"
    href="/docs/cli"
    description="Drive the same operations from a terminal. Useful for the first call and for anything you would otherwise script by hand."
  />
  <Card
    title="API reference"
    href="/docs/api/reference"
    description="Every operation the published OpenAPI document describes, one page per resource, each runnable from the page itself."
  />
  <Card
    title="Hosted MCP server"
    href="/docs/concepts/meta-tools"
    description="One URL gives Claude Code, Claude Desktop, Cursor, Windsurf or any other client the 15 meta-tools, without writing HTTP or installing anything."
  />
  <Card
    title="@codespar/mcp (local)"
    href="/docs/api/sdk/providers/mcp"
    description="The same server as a stdio process, for clients that spawn one: install, setup mode, config helpers, troubleshooting."
  />
  <Card
    title="Framework adapters"
    href="/docs/api/sdk/providers"
    description="langchain, crewai, vercel, openai, llama-index, mastra, autogen, camel, letta and google-genai, exposing the same tools."
  />
  <Card
    title="Test mode"
    href="/docs/concepts/test-mode"
    description="The csk_test_ prefix picks the environment, not the host. What is real in sandbox and what is not."
  />
</Cards>

## Machine-readable contracts

The documents an agent fetches without asking a person. Each is served without a credential.

<Cards>
  <Card
    title="OpenAPI document"
    href="/docs/api/reference/openapi-json"
    description="The contract itself, at api.codespar.dev/openapi.json. Generate a client from it instead of reading pages."
  />
  <Card
    title="Types package"
    href="/docs/api/api-types"
    description="@codespar/api-types: the shapes the runtime validates against, published to npm."
  />
  <Card
    title="Tool calls over HTTP"
    href="/docs/api/tools"
    description="Calling a meta-tool without the SDK, when your runtime is not TypeScript."
  />
</Cards>

## Tools

<Cards>
  <Card
    title="Agent-Ready check"
    href="/docs/check"
    description="Score any site on what an agent can discover about it. The same scanner we run against ourselves."
  />
  <Card
    title="MCP generator"
    href="/docs/mcp-generator"
    description="Point it at an API and get an MCP server. Scans the surface, builds the tools, and hands you something to run."
  />
  <Card
    title="Build your own"
    href="/docs/build-your-own"
    description="Publish a server into the catalog so other people's agents can find and call it."
  />
  <Card
    title="Server catalogue"
    href="/docs/servers"
    description="What is already connectable, by category and country, with its authentication shape."
  />
</Cards>

## Reliability and debugging

<Cards>
  <Card
    title="Debugging"
    href="/docs/debugging"
    description="What to do when a call does not do what you expected, and which identifier to quote."
  />
  <Card
    title="Error reference"
    href="/docs/errors"
    description="The refusal codes, what each one means, and which are worth retrying."
  />
  <Card
    title="Triggers"
    href="/docs/concepts/triggers"
    description="Subscribe to events instead of polling. Deliveries, dead letters and redelivery."
  />
  <Card
    title="Webhooks"
    href="/docs/concepts/webhooks"
    description="Receiving provider events, and how they reach your endpoint."
  />
</Cards>

## Security and governance

<Cards>
  <Card
    title="Authentication"
    href="/docs/concepts/authentication"
    description="Keys, scopes and OAuth 2.1. What a key can reach, and how the environment is chosen."
  />
  <Card
    title="Guardrails"
    href="/docs/concepts/guardrails"
    description="Signed mandates with a cap and an expiry. A call that would exceed one is refused before money moves."
  />
  <Card
    title="Agent identity"
    href="/docs/concepts/agent-trust"
    description="Who an agent is, and what that claim is worth to the other side."
  />
  <Card
    title="Audit chain"
    href="/docs/concepts/audit-chain"
    description="The append-only record of what was spent under which mandate, and how to verify it."
  />
</Cards>

## Versioning

<Cards>
  <Card
    title="Changelog"
    href="/docs/changelog"
    description="What changed, when, and whether it changes anything you already shipped."
  />
</Cards>