A single REST endpoint hits any agent in the DCS library. OpenAI-compatible chat completions, structured outputs, tool calling, vision, voice. Every response includes a hash-chained ed25519 receipt — independently verifiable on our public verifier without trusting our servers.
One REST surface to discover agents, run them, stream tokens, attach tools, and verify receipts.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/agents | List all 641 agents with metadata + capabilities |
| GET | /v1/agents/{id} | Agent details — schema, modalities, pricing tier, sample I/O |
| POST | /v1/agents/{id}/run | Run agent with input; returns output + receipt CID (streaming optional) |
| POST | /v1/chat/completions | OpenAI-compatible — drop-in for any client using OpenAI SDK |
| GET | /v1/receipts/{cid} | Verify a receipt without auth — public endpoint, no trust required |
Bearer token in Authorization header. Best for server-side. Generate in dashboard, rotate any time. Scopes by agent + spend cap.
For browser clients calling on behalf of a signed-in user. Auto-validates against DCS-auth Supabase project, returns 401 on stale.
For Claude Desktop / Cursor / Windsurf — the agent appears as a native tool, MCP handles handshake + auth.
Use the OpenAI SDK you already have, or pick the typed DCS client.
// npm install @dcsplatform/sdk import { DCS } from "@dcsplatform/sdk"; const dcs = new DCS("dcs_••••"); const r = await dcs.agents.run("restaurant.intake", msg); console.log(r.output, r.receipt_cid);
# pip install dcsplatform from dcsplatform import DCS dcs = DCS(api_key="dcs_••••") r = dcs.agents.run("restaurant.intake", msg) print(r.output, r.receipt_cid)
from openai import OpenAI client = OpenAI( base_url="https://api.dcsai.ai/v1", api_key="dcs_••••", ) r = client.chat.completions.create(...)
Pricing scales with the model tier you call. Receipts are always free — signing is part of the substrate.
$0.04 / 1M output tokens · cheap, fast, open-weight
Llama, Qwen, Mistral, DeepSeek + DCS-tuned variants. Sub-3s p50.
passthrough · GPT-5, Claude Sonnet, Gemini
Hit any frontier model with the same receipt envelope.
BYO weights · self-hosted
Point at your own vLLM endpoint; we sign the receipts.
Free tier: 10K calls/month on Tier 0 · no card required · Sign up →
base_url=https://api.dcsai.ai/v1 in the OpenAI SDK and your existing code works. We add a x-dcs-receipt-cid response header so you can pull the signed receipt for any call./v1/agents/{your-id}/run endpoint automatically. See Agent Studio.receipt_cid. The receipt is an ed25519-signed JSON envelope: input hash, output hash, model, cost, timestamp, prev_receipt_cid pointer. Chain pins to Filecoin. Anyone can verify via GET /v1/receipts/{cid} or the npm verifier — no auth needed.Stand up your first agent integration in 5 minutes. No card for the free tier.