For AI tools & agents

Start with static JSON on any host, add local MCP when you need tools, then optional hosted Worker routes on cachesphere.com. Transfer runs client-side from /api/languages.json on the public site; /v1/* is Node/self-host only (404 here). Catalogue snippets are copy-only — CacheSphere does not execute them. llms.txt

Static JSON (start here)

Fetch once, cache locally. No server required.

MCP (local stdio)

From the repo root: node bin/cachesphere-mcp.mjs — no Express server required.

select_context_packs

Pick packs for a task.

get_decision_kit_context

Decision Brief as JSON.

get_context_pack

Fetch one pack by ID.

search_context_packs

Keyword search.

Also: build_experiment_context, generate_runtime_preflight, report_outcome, refresh_cachesphere_cache.

Hosted Worker routes (cachesphere.com)

GET /api/agent/tools is the live inventory. Hosted Worker routes: POST /api/agent/select-context-packs, POST /api/agent/decision-kit, and POST /api/agent/experiment-context. These run on the Cloudflare Worker — not the Node server. Decision-kit is a lightweight keyword matcher (languages named in the prompt only) — prefer Advisor or MCP get_decision_kit_context for fuller briefs.

  • GET /api/agent/tools — inventory
  • POST /api/agent/select-context-packs
  • POST /api/agent/decision-kit
  • POST /api/agent/experiment-context
curl -s https://cachesphere.com/api/agent/tools curl -X POST https://cachesphere.com/api/agent/select-context-packs \ -H "Content-Type: application/json" \ -d '{"input": "Build a CRUD API in TypeScript"}'
Reference

Self-host only

/v1/transfer and other /v1/* routes need server/index.mjs. They are not on the public static site.

Schemas