sam1siam/astrofabric-mcp

**AstroFabric** is agentic AI for business intelligence: autonomous data infrastructure that turns strategic objectives into verified datasets and live intelligence streams. Its agents discover companies and people, execute deep enrichment, verify corporate and contact records, monitor real-time business and marketplace signals, score and segment targets, build matched audiences, and deliver structured intelligence into CRMs, commerce systems, ad platforms, operational sheets, messaging channels, or any application through REST, MCP and CLI. Every workflow carries evidence and operates within approval gates, audit trails and credit ceilings. This MCP server puts that infrastructure behind your editor, give mission_agent an open-ended objective in plain language and it plans and executes the mission, returning the finished data with the evidence behind it..
This repository is both the connector for the **hosted** AstroFabric MCP endpoint (add the remote URL with your API key and start working) and a runnable **stdio server** for clients that prefer a local process - see Run it locally.
- Website: https://www.astrofabric.ai
- Endpoint: https://www.astrofabric.ai/api/mcp (Streamable HTTP)
- Docs: https://www.astrofabric.ai/docs
Prerequisites
1. An AstroFabric workspace on a paid plan - sign up at https://www.astrofabric.ai
2. An API key: in the AstroFabric console, open **API keys** → **Create key**, and copy the ek_live_... token (it is shown once).
Setup
Every client uses the same endpoint (https://www.astrofabric.ai/api/mcp) and the same key. Pick yours:
Claude Code
claude.ai / Claude Desktop (OAuth - no key needed)
Add a custom connector with the bare URL and sign in when prompted - the server walks you through AstroFabric sign-in and hands the client a scoped key you can revoke from the console:
Cursor
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
Cline
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure, or *Remote Servers* → add by URL):
VS Code (Copilot agent mode)
Add to .vscode/mcp.json:
Codex
Add to ~/.codex/config.toml:
Gemini CLI
Install the extension (OAuth - the first call opens AstroFabric sign-in in your browser):
Or, with an API key, add to ~/.gemini/settings.json under mcpServers:
ChatGPT and the Gemini app (OAuth - no key needed)
Chat assistants stop a tool call after about a minute, so they use the chat surface, where a mission starts in the background and its result is collected when it is ready. Add it as a custom connector (ChatGPT developer mode) or a connected app (Gemini) and sign in when prompted:
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
Shortcut: with the CLI installed, astrofabric connect prints your client's config with your key already filled in.
If your client cannot send headers, the key can ride the URL instead: https://www.astrofabric.ai/api/mcp?key=ek_live_YOUR_KEY_HERE - treat that whole URL as a secret.
Three tool surfaces
- **Default** (the URL above): one tool, mission_agent - the autonomous mission runner. Best for editors: one entry in your tool list, the whole platform behind it.