DEVELOPERSMACHINE-READABLE ROOTSHIFT

Rootshift API docs for agents.

Everything this site says is available programmatically: a public, read-only MCP server, every page as Markdown, and standard discovery files. No API keys, no sign-up. Rootshift is delivered by Rootstrap; to engage the team, the server points you to rootstrap.com/contact.

Quickstart

# Claude Code
claude mcp add --transport http rootshift https://rootshift.ai/api/mcp

# Any MCP client
{ "mcpServers": { "rootshift": { "type": "http", "url": "https://rootshift.ai/api/mcp" } } }

# Raw JSON-RPC
curl -s https://rootshift.ai/api/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_constitution","arguments":{}}}'

# Any page as Markdown
curl -s -H 'Accept: text/markdown' https://rootshift.ai/

Tools

ToolArgumentsReturns

get_overviewformat: short | fullThe llms.txt or llms-full.txt profile. Read this first.

get_page_markdownpathA rootshift.ai page as clean Markdown.

get_ground_truth_model—The seven parts of a Ground Truth, the metadata contract, the lifecycle.

get_method—The four-step delivery chain, the six-stage loop, the standing rules.

get_constitution—The ten principles the system enforces.

contact_rootstraptopic?How to engage Rootstrap, the company that delivers Rootshift. Files nothing.

Errors and limits

Protocol errors are JSON-RPC error objects; tool failures are results with isError: true. Unknown /api/* paths return HTTP 404 with a JSON body (error.code, message, hint, docs). Every API response carries RateLimit-Policy: 120;w=60, RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset; over the limit, 429 with Retry-After.

Discovery files

/openapi.json OpenAPI 3.1 for the MCP endpoint and health.
/.well-known/mcp/server-card.json MCP Server Card. Also /.well-known/mcp.json and registry-style /.well-known/mcp/server.json.
/.well-known/api-catalog API catalog (RFC 9727).
/.well-known/agent-skills/index.json Agent skill for using this server, with digest.
/.well-known/ai-catalog.json Resource manifest (ARD).
/llms.txt Short profile for AI systems, with a when-to-use section for agents.
/mcp.md This page as Markdown.

Every response carries Link headers (describedby, api-catalog, service-desc) and Vary: Accept. Content preferences: robots.txt. Liveness: /api/health.