ExoGraph API

Appearance

MCP Troubleshooting ​

Common issues and solutions.

Claude Desktop Not Recognizing MCP ​

Symptoms ​

  • Claude doesn't respond to ExoGraph commands
  • Tools list doesn't include ExoGraph
  • No errors, just no response

Solutions ​

  1. Check configuration location:

    bash
    # macOS/Linux
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
type %APPDATA%\Claude\claude_desktop_config.json

  2. Verify JSON syntax:

    Your config must be valid JSON:

    json
    {
  "mcpServers": {
    "exograph": {
      "url": "https://exograph.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer exo_key_live_..."
      }
    }
  }
}

    Common mistakes:

    • Missing commas
    • Extra commas after last item
    • Wrong quotes (use ", not ')
    • Missing closing braces

  3. Restart completely:

    • Quit Claude Desktop (don't just close window)
    • Wait 5 seconds
    • Reopen
    • Try again

  4. Check Claude Desktop version:

    Make sure you're using a version that supports MCP (Claude Desktop 0.7.0+)

Authentication Errors ​

Symptoms ​

  • "Authentication failed"
  • "Invalid API key"
  • "Unauthorized" errors
  • 401 HTTP errors

Solutions ​

  1. Verify API key format:

    API keys start with exo_key_live_:

    exo_key_live_a1b2c3d4e5f6...

  2. Check key is active:

  3. Copy key correctly:

    • Don't include extra spaces
    • Don't include line breaks
    • Copy the entire key
    • Use "Bearer" prefix in config

  4. Update configuration:

    json
    {
  "mcpServers": {
    "exograph": {
      "url": "https://exograph.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NEW_KEY_HERE"
      }
    }
  }
}

  5. Test with cURL:

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

    If this fails, your API key is invalid.

"No Graphs Found" ​

Symptoms ​

Claude says "You don't have any graphs yet"

Solutions ​

  1. Upload documents first:

    • Go to ExoGraph App
    • Upload a PDF or document
    • Wait for processing (may take 1-2 minutes)
    • Try MCP again

  2. Check correct account:

    Make sure your API key matches the account with documents:

    bash
    curl https://exograph.ai/api/graphs \
  -H "Authorization: Bearer YOUR_KEY"

  3. Verify upload succeeded:

    Check in the web app that your documents show up

  4. Wait for processing:

    Document processing may take a minute. Try:

    • "Check my ExoGraph graphs again"

Rate Limit Errors ​

Symptoms ​

  • "Rate limit exceeded"
  • "Too many requests"
  • 429 HTTP errors

Solutions ​

  1. Check limits:

    • 60 requests per minute
    • 10,000 requests per day

  2. Wait and retry:

    Wait 60 seconds if you hit per-minute limit

  3. Optimize queries:

    Instead of:

    • ❌ "Search for A, search for B, search for C" (3 requests)

    Try:

    • ✅ "Search for A, B, and C" (1 request, Claude batches)

  4. Check headers:

    bash
    curl -I https://exograph.ai/api/mcp/ \
  -H "Authorization: Bearer YOUR_KEY"

    Look for:

    • X-RateLimit-Remaining
    • X-RateLimit-Reset

Learn more about rate limits →

Slow Responses ​

Symptoms ​

  • MCP calls take a long time
  • Timeouts
  • Claude seems stuck

Solutions ​

  1. Normal for research:

    Research sessions can take 1-2 minutes. This is expected:

    • Web search takes time
    • AI analysis requires processing
    • Multiple sources need synthesis

  2. Reduce result count:

    "Search for X, limit to 5 results"

  3. Check ExoGraph status:

    Verify the service is healthy:

    bash
    curl https://exograph.ai/health

  4. Network issues:

    Test your connection:

    bash
    ping exograph.ai

Insufficient Credits ​

Symptoms ​

  • "Insufficient tokens"
  • Research won't start
  • 402 Payment Required

Solutions ​

  1. Check balance:

    Ask Claude:

    "What's my ExoGraph token balance?"

    Or via REST API:

    bash
    curl https://exograph.ai/api/billing/tokens \
  -H "Authorization: Bearer YOUR_KEY"

  2. Purchase credits:

    Go to Billing Settings

  3. Set budget limits:

    Prevent overspending:

    "Start research with a budget of 50 credits"

  4. Use free operations:

    These don't consume credits:

    • List graphs
    • Search entities
    • Get graph data
    • Check research status

Learn more about pricing →

Multiple ExoGraph Configurations ​

Issue ​

Using different API keys for work/personal

Solution ​

Use named configurations:

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

Then specify:

"Search exograph-work for X"
"List exograph-personal graphs"

Claude Can't Parse Results ​

Symptoms ​

  • Claude says "I couldn't understand the response"
  • Garbled output
  • Error messages in results

Solutions ​

  1. Update Claude Desktop:

    Make sure you're on the latest version

  2. Simplify query:

    Instead of complex multi-step:

    • Try one action at a time
    • Break into smaller queries

  3. Check API response:

    Test directly:

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

    If response is malformed, contact support.

Debugging ​

Enable Logging ​

Check Claude Desktop logs:

bash
# macOS
tail -f ~/Library/Logs/Claude/mcp.log

# Windows
Get-Content $env:APPDATA\Claude\logs\mcp.log -Wait

# Linux
tail -f ~/.config/Claude/logs/mcp.log

Test MCP Endpoint ​

Test the endpoint is responding:

bash
# Check server info
curl https://exograph.ai/api/mcp/

# Test initialize
curl -X POST https://exograph.ai/api/mcp/ \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {}
  }'

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

Validate JSON Config ​

Use a JSON validator:

bash
# macOS/Linux
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

# Or use online: https://jsonlint.com/

Common Error Messages ​

"Method not found" ​

Cause: Invalid JSON-RPC method name

Solution: This is usually a bug. Contact support with:

  • What you asked Claude
  • Exact error message

"Invalid params" ​

Cause: Missing required parameter for a tool

Solution: This is usually handled by Claude. If you see this:

  • Try rephrasing your question
  • Be more specific about what you want

"Internal error" ​

Cause: Server-side issue

Solution:

  1. Try again in a few seconds
  2. Check Status Page (if exists)
  3. Contact support if persists

Still Having Issues? ​

1. Check Documentation ​

2. Test REST API ​

If MCP doesn't work but REST API does, it's a configuration issue:

REST API Documentation →

3. Contact Support ​

Email: support@exograph.ai

Include:

  • Your configuration (redact API key!)
  • Error messages
  • What you tried
  • Claude Desktop version
  • Operating system

4. Community ​

  • GitHub Discussions (if available)
  • Discord Server (if available)

Known Limitations ​

Current version limitations:

  1. No streaming: Research status requires manual checks
  2. No document upload: Can't upload documents via MCP (use web app or REST API)
  3. No graph creation: Can't create new graphs via MCP
  4. No visualization: Results are text-only (no graph visualizations)
  5. No batch requests: One request at a time

These are planned for future releases.

Reporting Bugs ​

Found a bug? Help us fix it:

  1. Verify it's reproducible:

    • Try multiple times
    • Try with different queries
    • Note exact steps

  2. Gather information:

    • Claude Desktop version
    • Operating system
    • Error message
    • What you expected
    • What actually happened

  3. Submit report:

FAQ ​

Q: Does MCP work with Cursor? ​

A: Yes, Cursor supports MCP. Configuration is similar to Claude Desktop.

Q: Can I use MCP without Claude Desktop? ​

A: Yes, any MCP-compatible client works. You can also call the endpoint directly via cURL or REST API.

Q: Is MCP free? ​

A: MCP itself is free. You only pay for:

  • Research sessions (30-100 credits)
  • Same costs as REST API

Search and graph operations are free.

Q: Can multiple people use the same API key? ​

A: Yes, but they'll share:

  • Rate limits
  • Credit balance
  • Access to same graphs

Consider separate keys for separate accounts.

Q: How do I revoke an API key? ​

A: Go to Settings → API Keys and delete the key.

Still stuck? Contact support@exograph.ai

Released under the MIT License.

Copyright © 2025 ExoGraph