# Gemral Edge MCP server

Remote MCP server for Gemral Edge: point-in-time U.S. public-record data (federal contracts, congressional and insider trades, lobbying, regulatory publications) and AI-infrastructure physical data, for AI assistants.

The server is hosted. This repository holds its public metadata (`server.json` for the official MCP Registry), connection instructions, and a small zero-dependency stdio proxy (`proxy.mjs`) for clients that only run local servers. The proxy forwards every request to the hosted server; it contains no data and no server code.

- Every record is tied to the company and ticker that were valid on the day it became public.
- Publication lags are applied, so the data can be joined without look-ahead.
- Each record type ships only after a sampled accuracy check against the original public documents (95% minimum).
- Delisted and acquired companies stay in the history under the ticker they had at the time.
- Data comes only from public sources and contains no material non-public information.
- Delivered as Parquet files, a REST API and an MCP server for AI assistants.
- For AI-infrastructure companies we also track data-center sites, air permits, permitted backup-generator MW, substations, grid demand, equipment imports, capex and satellite measurements.

Known limits worth reading before you rely on the data:

- Roughly half of events on delisted tickers have historical prices; results on delisted names can be biased upward by survivorship.
- Permitted backup-generator MW is an upper bound on on-site backup capacity, not IT load; we do not convert it.
- Imports are industry context by product code and origin country, not company-level shipments.

## Connect

- **Server URL (streamable HTTP):** `https://mcp.gemral.com/mcp`
- **Auth:** OAuth (clients that support MCP authorization discover it automatically) or an API key sent as `Authorization: Bearer <key>`.
- **Keys and plans:** https://www.gemral.com/edge/pricing · questions: support@gemral.com

Claude (custom connector) or ChatGPT (connector): add the server URL above and sign in when prompted.

Cursor, Windsurf and other clients that take a JSON config:

```json
{
  "mcpServers": {
    "gemral-edge": {
      "url": "https://mcp.gemral.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_GEMRAL_EDGE_KEY" }
    }
  }
}
```

### Local stdio proxy (npx or Docker)

For clients that only launch local commands. Requires Node 18+.

```json
{
  "mcpServers": {
    "gemral-edge": {
      "command": "npx",
      "args": ["-y", "github:gemral-edge/gemral-edge-mcp"],
      "env": { "GEMRAL_EDGE_API_KEY": "YOUR_GEMRAL_EDGE_KEY" }
    }
  }
}
```

Docker: `docker build -t gemral-edge-mcp . && docker run -i --rm -e GEMRAL_EDGE_API_KEY=YOUR_GEMRAL_EDGE_KEY gemral-edge-mcp`

Without `GEMRAL_EDGE_API_KEY` the proxy still answers `tools/list` from the bundled `tools.json` (generated from the hosted server's `tools/list`), and tool calls return a message explaining how to get access. No key? Connect your client to the server URL above instead and sign in with OAuth (free tier).

## Tools

37 tools, as returned by the server's `tools/list`:

- `get_company_exposure`
- `get_event_expected_impact`
- `get_contract_beneficiaries`
- `get_policy_affected_companies`
- `get_signal_historical_outcomes`
- `screen_convergence`
- `explain_score`
- `get_top_signals`
- `get_leaderboard`
- `get_track_record`
- `get_forecast`
- `get_ticker_intelligence`
- `get_actor_profile`
- `get_crypto_funding_extremes`
- `get_onchain_whale_flows`
- `audit_cluster_insider_buying`
- `get_committee_conflict_map`
- `scan_crypto_patterns`
- `get_physical_footprint`
- `search_management_promises`
- `get_open_promises`
- `get_overdue_promises`
- `get_management_credibility`
- `compare_management_teams`
- `get_claim_history`
- `verify_claim`
- `get_language_drift`
- `get_guidance_accuracy`
- `search_accountability_people`
- `get_upcoming_catalysts`
- `get_breakout_watch`
- `get_precursor_signals`
- `get_event_impact_preview`
- `get_policy_intelligence_feed`
- `get_beneficiary_tickers`
- `get_event_countdown`
- `verify_event_status`

## Documentation

- Data due-diligence questionnaire (methods, coverage, known limits): https://www.gemral.com/edge-ddq.md
- API quickstart: https://www.gemral.com/edge-api-quickstart.md
- Data license: https://www.gemral.com/edge-api-license.md

Fields derived from map data and satellite imagery carry these attributions: "© OpenStreetMap contributors" and "Contains modified Copernicus Sentinel data 2023-2026".

Output is informational and is not investment advice.

## License

The files in this repository (README and metadata) are MIT licensed. Data returned by the server is covered by the Gemral Edge data license linked above.