@42a/mcp

Model Context Protocol server for the 42a brand-visibility platform. Lets Claude Desktop, Claude Code, Cursor, and other MCP clients query your 42a data conversationally.

Install

// claude_desktop_config.json
{
  "mcpServers": {
    "42a": {
      "command": "npx",
      "args": ["-y", "@42a/mcp@latest"],
      "env": {
        "API_42A_KEY": "ck_live_...",
        "API_42A_ORG_ID": "org_xxx",
      },
    },
  },
}

• API_42A_KEY - required. Generate in your 42a settings (org or user key).
• API_42A_ORG_ID - required when using a user API key on org-scoped tools. For org keys, leave it unset.
• API_42A_BASE_URL - optional override; defaults to https://api.42a.ai.

Tools

| Tool | What it does | | ------------------------------- | ---------------------------------------------------------------- | | list_organizations | Orgs the caller can access. | | get_me | Identity + accessible orgs. | | list_projects / get_project | Analysis projects. | | list_prompts / get_prompt | Prompt templates. | | list_brands / get_brand | Brands tracked in the org. | | list_citations | Citations (requires one of project_id / prompt_id / website_id). | | get_org_vitals | Org-level visibility rollup over 7d / 30d / 90d. | | list_page_vitals | Tracked pages + feature scores for a given brand. |

The full request/response schema is in docs/openapi.yaml.