Skip to content

MCP Quick Setup

Set up ExoGraph MCP integration in 30 seconds.

Prerequisites

  • Claude Desktop or Cursor installed
  • ExoGraph API key (get one here)

Setup for Claude Desktop

macOS/Linux

  1. Open config file:
bash
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. Add ExoGraph configuration:
json
{
  "mcpServers": {
    "exograph": {
      "url": "https://exograph.ai/api/mcp/",
      "headers": {
        "Authorization": "Bearer exo_key_live_YOUR_KEY_HERE"
      }
    }
  }
}
  1. Save and restart Claude Desktop

  2. Test it:

Ask Claude: "List my ExoGraph knowledge graphs"

Windows

  1. Open config file:
powershell
notepad %APPDATA%\Claude\claude_desktop_config.json
  1. Add same configuration as above

  2. Restart Claude Desktop


Setup for Cursor

INFO

Cursor MCP configuration uses the same format as Claude Desktop. Check Cursor's documentation for the config file location.


Verify Setup

Method 1: Ask Claude

"List my ExoGraph knowledge graphs"

You should see your graphs listed.

Method 2: Check Tools

"What ExoGraph tools are available?"

You should see 11+ tools listed, including search, upload, chat, and research capabilities.


Multiple API Keys

Use different keys for different projects:

json
{
  "mcpServers": {
    "exograph-work": {
      "url": "https://exograph.ai/api/mcp/",
      "headers": {
        "Authorization": "Bearer exo_key_live_work_key"
      }
    },
    "exograph-personal": {
      "url": "https://exograph.ai/api/mcp/",
      "headers": {
        "Authorization": "Bearer exo_key_live_personal_key"
      }
    }
  }
}

Then specify: "Search exograph-work for X"


Testing the Connection

Test with cURL

Verify the MCP endpoint is working:

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

Expected response:

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "search_entities",
        "description": "Search for entities in knowledge graphs..."
      },
      ...
    ]
  }
}

Common Setup Issues

Configuration Not Working?

  1. Check JSON syntax - No trailing commas, proper quotes
  2. Restart completely - Quit Claude Desktop entirely, not just close
  3. Verify API key - Copy from Settings → API Keys
  4. Check file location - Make sure you're editing the right config file

Full Troubleshooting Guide →


Next Steps

Released under the MIT License.