Quickstart

Five minutes from zero to your first tool call.

How do I set up the Mentionable MCP?

Three steps: create an API key, paste the config into your client, run a hello-world tool call. The endpoint and authentication are identical across all clients — only the JSON wrapper differs.

1. Create a Mentionable API key

1. Log in at mentionable.ai.
2. Open Settings → API Keys (MCP).
3. Click Create key, name it (e.g. claude-desktop-laptop), optionally restrict it to specific projects.
4. Copy the token. It starts with mnt_sk_ and is shown only once.

The Mentionable API key inherits the permissions of the workspace member who created it. Project-scope restrictions on the key intersect with member-level project restrictions. A revoked key cannot be re-used; create a new one to replace it.

2. Connect your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{
  "mcpServers": {
    "mentionable": {
      "url": "https://mentionable.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer mnt_sk_xxx"
      }
    }
  }
}

Quit and relaunch Claude Desktop. The Mentionable tools appear in the tools menu of any new conversation.

Cursor

Open Cursor Settings → MCP → Add new MCP server. Use the same JSON:

{
  "mcpServers": {
    "mentionable": {
      "url": "https://mentionable.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer mnt_sk_xxx"
      }
    }
  }
}

The Mentionable tools become available to the Cursor agent in any chat.

n8n

Use the MCP Client node (n8n version 1.65 or later):

• Endpoint: https://mentionable.ai/api/mcp
• Authentication: Header Auth, set Authorization to Bearer mnt_sk_xxx
• Operation: Execute tool, pick a tool, fill in arguments.

Common pattern: Cron → MCP (list_prompts) → Function → Slack.

VS Code with GitHub Copilot Chat

Add to settings.json:

{
  "mcp.servers": {
    "mentionable": {
      "url": "https://mentionable.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer mnt_sk_xxx"
      }
    }
  }
}

curl (sanity check)

curl -X POST https://mentionable.ai/api/mcp \
  -H "Authorization: Bearer mnt_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

A successful response is a JSON-RPC payload listing eight tools. A 401 means the key is wrong or revoked. A 429 means more than 100 requests in the last 60 seconds.

3. Run a hello-world tool call

Once connected, ask the agent:

List my Mentionable projects, then for the first one, show me the top 10 most-cited domains across all LLMs.

The agent chains list_projects → list_llm_sources and renders a table. That is the canonical Mentionable MCP pattern: discover the project, then drill into one resource.

Common errors

Error	Cause	Fix
401 Unauthorized	Missing or invalid token.	Verify the Authorization: Bearer header and that the key is not revoked.
403 FORBIDDEN — Project not in API key scope	The key was restricted to certain projects, the requested one is not in the list.	Use a project ID from list_projects or widen the key scope.
429 RATE_LIMITED	More than 100 requests in 60 seconds for this key.	Slow down. Read the Retry-After header.
Tool returns empty data	Filters too narrow, or no data yet (project just created).	Loosen filters; wait for the first daily scan to complete.
Project not found	Project does not belong to your tenant or member scope.	Confirm the ID by calling list_projects first.
Tools missing in Claude Desktop	Config JSON syntax error, or app not restarted after edit.	Validate the JSON, then quit and relaunch the app.

Next steps

• Skim Concepts to understand fan-out queries and the source taxonomy.
• Pick a workflow in Use cases and copy the system prompt into your agent.
• Read Authentication before sharing keys with teammates.