API and MCP

Authentication

Create a key on the personal API keys page. We show the key once. Copy it, then store it in a password manager or a secret manager. We keep only the SHA-256 hash of the key, so we cannot show it again.

Send the key in the Authorization header on every request:

curl -H "Authorization: Bearer cdu_..." \
  https://capdaddy.cc/api/v1/me

Revoke a key at any time on the same page. Revocation takes effect on the next request. Your role is resolved again on every request, so a role change applies immediately.

Endpoints

Replace {org} with the organization id from /api/v1/orgs. The role column is the role you need in that organization.

An organization manager can switch the member API off for their organization. The organization then disappears from your list, and its endpoints answer 404. Your own holder portfolio is not affected.

Parameters

curl -H "Authorization: Bearer cdu_..." \
  "https://capdaddy.cc/api/v1/orgs/<org>/captable?asOf=2026-06-30&basis=outstanding"

Numbers are strings

{
  "outstanding": "1750000",
  "fullyDiluted": "2431250",
  "pricePerShare": "1.2500000000"
}

Reading the values

Seven rules cover the fields that are easy to misread. Follow each one before you put a number in front of an investor.

Errors

Export kinds

Request an export at /api/v1/orgs/{org}/exports/{kind}. The response is the file itself. Some kinds need a paid plan, and an unentitled request answers 402.

The audit log and the diligence bundle are not on this list. Both need a fresh confirmation in the product, so no long lived key can reach them.

MCP server

The MCP server gives an AI assistant the same read tools, over the same key. Point your client at this URL and send your key in the Authorization header:

https://capdaddy.cc/api/mcp/mcp

Tools

Each tool reads one organization. Pass the organization id from list_orgs. A tool answers the text not_found for every miss, the same way the REST endpoints answer 404.

The MCP server sends text only. It never sends a file. Call list_export_kinds to learn which export files exist, then fetch the one you want from the REST endpoint with the same key. No tool writes data.

Claude Code

Run one command:

claude mcp add --transport http capdaddy https://capdaddy.cc/api/mcp/mcp \
  --header "Authorization: Bearer cdu_..."

Claude Desktop

Claude Desktop connects to a remote server through mcp-remote. Open Settings, then Developer, then Edit Config. Add this server, then restart Claude Desktop.

{
  "mcpServers": {
    "capdaddy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://capdaddy.cc/api/mcp/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer cdu_..."
      }
    }
  }
}

Put your key in the env block, and leave no space after the colon in the header argument. On Windows, the client does not escape a space inside an argument, and a header written in one piece arrives broken.

Cursor

Add the server to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.

{
  "mcpServers": {
    "capdaddy": {
      "url": "https://capdaddy.cc/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer cdu_..."
      }
    }
  }
}

VS Code

Add the server to .vscode/mcp.json, then start it from the editor.

{
  "servers": {
    "capdaddy": {
      "type": "http",
      "url": "https://capdaddy.cc/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer cdu_..."
      }
    }
  }
}

OpenCode

Add the server to opencode.json in your project, or to ~/.config/opencode/opencode.json for every project.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "capdaddy": {
      "type": "remote",
      "url": "https://capdaddy.cc/api/mcp/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer cdu_..." }
    }
  }
}

Keep oauth set to false. OpenCode tries OAuth first on a remote server, and this server accepts a bearer key only.

OpenAI Codex CLI

Codex reads the key from an environment variable. Add this line to your shell profile, then open a new terminal.

export CAPDADDY_API_KEY="cdu_..."

Then add the server to ~/.codex/config.toml.

[mcp_servers.capdaddy]
url = "https://capdaddy.cc/api/mcp/mcp"
bearer_token_env_var = "CAPDADDY_API_KEY"

The config file holds the name of the variable, never the key itself.