Official MCP (Model Context Protocol) server for connecting AI agents to the RoboSystems Financial Knowledge Graph API. Query financial statements, explore graph structures, resolve XBRL elements, and build fact grids — all from Claude Desktop, Claude Code, Cursor, or any MCP-compatible client.
- Financial data tools for statements, disclosures, and multidimensional fact grids
- Graph exploration with Cypher queries, schema introspection, and element resolution
- Workspace management for isolated subgraphs, staging data, and persistent agent memory
- Streaming support via SSE and NDJSON for large result sets
- Connection pooling with LRU eviction for optimal performance
- Smart caching for frequently accessed schemas and metadata
- Automatic retry logic with exponential backoff
Add to your MCP servers configuration:
{
"mcpServers": {
"robosystems": {
"command": "npx",
"args": ["-y", "@robosystems/mcp"],
"env": {
"ROBOSYSTEMS_API_URL": "https://api.robosystems.ai",
"ROBOSYSTEMS_API_KEY": "rfs...",
"ROBOSYSTEMS_GRAPH_ID": "kg..."
}
}
}
}| Variable | Description | Default |
|---|---|---|
ROBOSYSTEMS_API_KEY |
Your API key | (required) |
ROBOSYSTEMS_GRAPH_ID |
Primary graph ID (parent for workspaces) | (required) |
ROBOSYSTEMS_API_URL |
API endpoint | https://api.robosystems.ai |
Tools are loaded dynamically from the RoboSystems API based on your graph. The client also provides built-in workspace management tools.
| Tool | Description |
|---|---|
get-financial-statement |
Retrieve structured financial statements (income, balance sheet, cash flow) by ticker and period |
list-disclosures |
List available disclosure types with counts, optionally filtered by ticker |
get-disclosure-detail |
Get facts for a specific disclosure type |
build-fact-grid |
Construct multidimensional fact grids from graph data for analysis |
| Tool | Description |
|---|---|
execute-cypher |
Run Cypher queries against the knowledge graph with validation and streaming |
get-graph-schema |
Introspect node types, relationships, and properties |
describe-graph-structure |
Explore graph structure and relationship patterns |
get-graph-info |
Graph metadata and statistics |
resolve-element |
Map financial concepts (e.g. "revenue") to XBRL element qnames |
resolve-structure |
Find financial statement structures by type |
get-properties |
Discover available properties on node types |
get-example-queries |
Query templates and examples for common patterns |
| Tool | Description |
|---|---|
create-workspace |
Create an isolated subgraph (static or memory type) |
switch-workspace |
Switch active workspace context |
list-workspaces |
List all workspaces with active indicator |
delete-workspace |
Remove a workspace and its data |
Workspaces let you create isolated subgraphs for experimentation, staging data, or persistent agent memory. Use subgraph_type: "memory" when creating a workspace to get a dedicated memory graph.
This project is licensed under the MIT License - see the LICENSE file for details.
MIT © 2026 RFS LLC