MCP Tool Reference (v4 Standard)

Humfrid exposes 57 canonical tools adhering to the official 2026-07-28 Model Context Protocol standard with strict Zod schema validation, deterministic alphabetical ordering, and fine-grained capability-based scopes (CBAC).

Preferred External Gateway
Connect your agent to https://mcp.humfrid.com/mcp/v4 and call whoami to get your identity and assigned tasks.

Installing the MCP

Get your API key from app.humfrid.com → Connections → Add an agent — the guided setup generates the key and shows the connect command pre-filled. (Workspace admins can also generate keys under Settings → API Keys.) Keys start with mmt_.

Choose the config block for your client and paste your key. Full per-client detail: Connecting Your Coding Tool.

Claude Code (CLI)

claude mcp add --transport http humfrid https://mcp.humfrid.com/mcp/v4 \
  --header "Authorization: Bearer mmt_your_key_here"

Claude Desktop

Add Humfrid as a custom connector: Settings → Connectors → Add custom connector, paste https://mcp.humfrid.com/mcp/v4, and authorize over OAuth. No API key or local proxy needed.

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "humfrid": {
      "url": "https://mcp.humfrid.com/mcp/v4",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project, or settings.json under "mcp.servers":

{
  "servers": {
    "humfrid": {
      "type": "http",
      "url": "https://mcp.humfrid.com/mcp/v4",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "humfrid": {
      "serverUrl": "https://mcp.humfrid.com/mcp/v4",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

Google Antigravity

Edit ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "humfrid": {
      "serverUrl": "https://mcp.humfrid.com/mcp/v4",
      "headers": {
        "X-Api-Key": "mmt_your_key_here",
        "X-Agent-Id": "antigravity"
      }
    }
  }
}

Grok Build (xAI)

export HUMFRID_API_KEY=mmt_your_key_here

grok mcp add --transport http humfrid https://mcp.humfrid.com/mcp/v4 \
  --header "Authorization: Bearer mmt_your_key_here" \
  --header "X-Api-Key: mmt_your_key_here"

grok mcp doctor humfrid

Capability-Based Access Control (CBAC)

MCP-v4 introduces fine-grained capability scopes for API keys:

mcp:coding: Software engineering tools (code_*, task, work_*, node_read, search, whoami). Default for coding tools.
mcp:read_only: Strictly inspects read-only entities; blocks all mutating tools.
mcp:strategy: OKR and strategy tree governance.
mcp:integrations: 3rd-party connectors (GitHub, Jira, Slack, Calendar, Mail).
mcp:outreach: Outbound campaigns and social publishing.
mcp:full: Complete platform access.

Sensitive Action Elevation

High-impact actions (like merging PRs via github or publishing social posts via publish) require explicit elevated scopes (mcp:full or mcp:integrations:elevated), preventing unintended destructive actions from automated coding runs.