Robosystems Mcp Client

RoboSystems MCP Client

[](https://www.npmjs.com/package/@robosystems/mcp) [](https://opensource.org/licenses/MIT)

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.

Features

• 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

Installation

Add to your MCP servers configuration:

{
  "mcpServers": {
    "robosystems": {
      "command": "npx",
      "args": ["-y", "@robosystems/mcp@latest"],
      "env": {
        "ROBOSYSTEMS_API_URL": "https://api.robosystems.ai",
        "ROBOSYSTEMS_API_KEY": "rfs...",
        "ROBOSYSTEMS_GRAPH_ID": "kg..."
      }
    }
  }
}

Environment Variables

| 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

Tools are loaded dynamically from the RoboSystems API based on your graph. The client also provides built-in workspace management tools.

Financial Data

| 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 |

Graph Exploration

| 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 |

Workspaces

| 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.

Resources

• RoboSystems Platform
• GitHub Repository
• MCP API Documentation
• OpenAPI Specification

Support

• Issues
• Wiki
• Projects
• Discussions

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

MIT © 2026 RFS LLC

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: RoboFinSystems
• Source: RoboFinSystems/robosystems-mcp-client
• License: MIT
• Homepage: https://robosystems.ai

Install and usage instructions live in the source repository linked above.