gildea 0.1.0

Python client and MCP server for the Gildea AI market intelligence API

Gildea

Python client and MCP server for the Gildea AI market intelligence API.

Gildea tracks 500+ expert sources on AI, decomposes every signal into verified reasoning chains (thesis, arguments, claims, evidence), and serves it through a REST API. This package gives you a Python client and an MCP server so AI assistants can use the data directly.

Install

# Python client only
pip install gildea

# With MCP server
pip install gildea[mcp]

Quick Start

from gildea_sdk import Gildea

client = Gildea(api_key="gld_your_key_here")

# Search verified text units
results = client.search.query(q="data center infrastructure spending")
for hit in results.data:
    print(f"{hit.unit.text}")
    print(f"  Source: {hit.citation.signal_title} ({hit.citation.registrable_domain})")

# Get full signal decomposition with evidence
signal = client.signals.get("signal_id", include="evidence")

# Entity intelligence with trend analytics
entity = client.entities.get("NVIDIA")
print(f"{entity.display_name}: {entity.direction}, {entity.scale} scale, {entity.priority} priority")

# Cross-source consensus mapping
similar = client.search.query(similar_to="unit_id")

MCP Server

Use Gildea as a tool in Claude, ChatGPT, Cursor, VS Code, or any MCP-compatible client.

# Run directly
gildea-mcp

# Or via uvx (no install needed)
uvx --from gildea[mcp] gildea-mcp

Set your API key:

export GILDEA_API_KEY=gld_your_key_here

Claude Desktop

Add to your claude_desktop_config.json:

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

Available MCP Tools

Tool	Description
search_text_units	Semantic search across verified text units, or vector similarity via similar_to
list_signals	Browse signals by entity, theme, date, content type
get_signal_detail	Full decomposition: thesis, arguments, claims, evidence
get_entity_profile	Entity trend analytics, co-occurrence, theme distribution
list_entities	Discover entities by trend direction, priority, scale
get_themes	Theme overview across value chain and market force axes
get_theme_detail	Single theme trend analytics and cross-theme relationships

API Key

Get your API key at gildea.ai. Free tier includes 5 requests/minute and 200 requests/month.

Documentation

Full API docs at docs.gildea.ai.

License

MIT