mcp-server: Instructions file for Codex

AGENTS.md

This project exposes an MCP server for creating and analyzing code vaults via The Code Registry - the World's first code intelligence and insight platform built for business leaders.

MCP endpoints

• Web app: https://app.thecoderegistry.com
• MCP server: https://integrator.app.thecoderegistry.com (POST to /api/ai/router)

Discovery

Use tools/list to discover available MCP tools and their input schemas. Use resources/list and resources/read for documentation, workflows, and examples. Use prompts/list and prompts/get for curated prompt templates.

Client compatibility note (Cursor / CallMcpTool wrappers)

• Known issue in some clients (notably some Cursor builds): the displayed CallMcpTool schema may omit arguments even though runtime forwarding supports it.
• For The Code Registry tools, always pass required tool inputs via CallMcpTool.arguments.
• If a tool has no required inputs, use arguments: {} for consistency.
• Example wrapper call shape:

{
  "server": "coderegistry",
  "toolName": "create-code-vault",
  "arguments": {
    "project_id": "<project_id>",
    "user_id": "<user_id>",
    "name": "My Code Vault",
    "source_type": "LOCAL_AGENT"
  }
}

Authentication

• create_account does not require an API key.
• All other MCP actions require X-API-Key using the key returned by create_account.
• Existing users can generate an API key in the web app and provide it directly via X-API-Key.
• If an MCP client cannot set custom headers, include api_key in the tool arguments. Header auth is preferred when available.

Plan behavior

• Free tier is limited to 100,000 total lines of code across all vaults.
• Free tier should still support registration, project/vault lifecycle, code sync, and summary-level analysis retrieval.
• Paid plans unlock extended functionality and richer payloads (for example full findings, verification badges/public verification pages, and Code Score out of 1,000).
• If a feature is plan-restricted, return the service error and direct users to upgrade in the web app.