MCP Server

Documentation Index

Fetch the complete documentation index at: https://docs.gildea.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Hosted server

​

Claude Desktop

1. Get your API key at gildea.ai.
2. Open your config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   Create it if it doesn’t exist.
3. Add Gildea to the mcpServers block:

{
  "mcpServers": {
    "gildea": {
      "url": "https://api.gildea.ai/mcp",
      "headers": {
        "x-api-key": "gld_your_key_here"
      }
    }
  }
}

4. Restart Claude Desktop. Click the tools icon in the chat input — Gildea’s 7 tools (search_text_units, get_signal_detail, etc.) should appear automatically.
5. Try: “Use Gildea to search for verified claims about data center power constraints.”

​

Claude Code

claude mcp add gildea --transport http https://api.gildea.ai/mcp --header "x-api-key: gld_your_key_here"

​

Other MCP clients

{
  "type": "http",
  "url": "https://api.gildea.ai/mcp",
  "headers": { "x-api-key": "gld_your_key_here" }
}

​

Local install (advanced)

​

Prerequisite

​

Claude Desktop config

{
  "mcpServers": {
    "gildea": {
      "command": "uvx",
      "args": ["--from", "gildea[mcp]", "gildea-mcp"],
      "env": {
        "GILDEA_API_KEY": "gld_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "gildea": {
      "command": "gildea-mcp",
      "env": { "GILDEA_API_KEY": "gld_your_key_here" }
    }
  }
}

​

Claude Code

claude mcp add gildea -- uvx --from "gildea[mcp]" gildea-mcp
# or
claude mcp add gildea -- gildea-mcp

​

Self-hosted Gildea API

"env": {
  "GILDEA_API_KEY": "gld_your_key_here",
  "GILDEA_API_BASE_URL": "https://your-api-host.example.com"
}

​

REST API vs MCP

​

Available tools

​

search_text_units

• q — free-text search. Returns the most relevant units across the corpus.
• similar_to — pass a text unit ID; returns units with similar stored embeddings (useful for cross-source corroboration and “find more like this”).

// Keyword search
{ "q": "GPU supply constraints", "unit_type": "analysis_claim", "limit": 5 }

// Similar-to search
{ "similar_to": "0004c6d0e2f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9", "limit": 5 }

​

list_signals

{ "entity": "gld:/e5f6a7b8c9d0", "content_type": "analysis", "limit": 5 }

​

get_signal_detail

{ "signal_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7", "include": "evidence" }

​

list_entities

{ "direction": "Rising", "confidence": "Significant", "sort": "trend", "limit": 10 }

​

get_entity_profile

{ "name_or_id": "NVIDIA" }

​

get_themes

• Value chain: Infrastructure, Foundation Models, Orchestration, Data & Labeling, Applications, Distribution
• Market force: Capital & Investment, Regulatory & Legal, Competitive Dynamics, Talent & Labor, Geopolitical Strategy, Trust & Societal Impact

{ "axis": "value_chain" }

​

get_theme_detail

{ "axis": "market_force", "label": "Geopolitical Strategy" }

​

Sample conversation

You: What are the most important things happening in AI right now?

Claude: Let me check the latest market intelligence. [Calls list_entities with direction=“Rising”, confidence=“Significant”, sort=“trend”] [Calls get_themes with axis=“value_chain”] Based on the latest signals from 500+ sources, here are the key dynamics: Rising entities:

• OpenAI — Large scale, Rising direction, Significant confidence. Notability: High.
• Anthropic — Medium scale, Rising direction. Steadily gaining share.

Hottest themes:

• Infrastructure — Rising with high confidence. The GPU/compute build-out narrative continues to intensify.
• Regulatory & Legal — Significant upward trend driven by EU AI Act implementation.

You: Dig into what’s driving the Infrastructure theme.

Claude: [Calls get_theme_detail with axis=“value_chain”, label=“Infrastructure”] [Calls list_signals with theme=“Infrastructure”, limit=5] The Infrastructure theme has a Theil-Sen slope of 0.12 (Rising, Significant, Steady). Here are the latest signals driving it:

1. “TSMC Accelerates CoWoS Capacity Expansion” — Analysis signal with 8 verified text units…
2. “Microsoft Plans $80B Data Center Spend” — Event signal…

You: Search for anything about chip export controls.

Claude: [Calls search_text_units with q=“chip export controls”] Found 10 verified text units across 7 signals. The top results include thesis sentences about supply chain restructuring and claims about NVIDIA’s H20 shipments to China…

​

Authentication & rate limits

​

Troubleshooting

​

”Authentication failed”

1. Check that GILDEA_API_KEY is set in your MCP config
2. Verify the key starts with gld_
3. Check your key status on the dashboard

​

”Rate limit exceeded”

1. Check your current tier’s limits in the table above
2. Wait for the retry-after interval (returned in the error message)
3. Consider upgrading your tier if you consistently hit limits

​

Tools not appearing in Claude Desktop

1. Restart Claude Desktop after editing the config file
2. Check the config path is correct: ~/Library/Application Support/Claude/claude_desktop_config.json on macOS
3. Verify the JSON is valid (no trailing commas)
4. Check Claude Desktop logs for connection errors

​

SSE connection issues

1. Ensure the port isn’t already in use: lsof -i :8001
2. Check that the server is running: curl http://localhost:8001/sse should initiate a stream
3. For remote connections, ensure firewalls allow the port

​

API connectivity issues

1. Verify GILDEA_API_KEY is set correctly
2. If using GILDEA_API_BASE_URL, check the URL is reachable: curl https://your-api-host/v1/health
3. Check for network/firewall issues if you get connection errors