https://github.com/robofinsystems/robosystems-mcp-client
Official MCP (Model Context Protocol) client adapter for connecting AI agents to the RoboSystems Financial Knowledge Graph API. Access comprehensive financial data including accounting transactions, financial reports, and advanced graph analytics with AI agents such as Claude, ChatGPT, Cursor, and more.
https://github.com/robofinsystems/robosystems-mcp-client
accounting client financial financial-analysis financial-data graph graph-api graphrag javascript mcp mcp-client robosystems
Last synced: about 18 hours ago
JSON representation
Official MCP (Model Context Protocol) client adapter for connecting AI agents to the RoboSystems Financial Knowledge Graph API. Access comprehensive financial data including accounting transactions, financial reports, and advanced graph analytics with AI agents such as Claude, ChatGPT, Cursor, and more.
- Host: GitHub
- URL: https://github.com/robofinsystems/robosystems-mcp-client
- Owner: RoboFinSystems
- License: mit
- Created: 2025-08-10T20:37:04.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-07-14T07:01:54.000Z (11 days ago)
- Last Synced: 2026-07-14T07:24:56.924Z (11 days ago)
- Topics: accounting, client, financial, financial-analysis, financial-data, graph, graph-api, graphrag, javascript, mcp, mcp-client, robosystems
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/@robosystems/mcp
- Size: 275 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```json
{
"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](https://robosystems.ai)
- [GitHub Repository](https://github.com/RoboFinSystems/robosystems)
- [MCP API Documentation](https://api.robosystems.ai/docs#tag/MCP)
- [OpenAPI Specification](https://api.robosystems.ai/openapi.json)
## Support
- [Issues](https://github.com/RoboFinSystems/robosystems-mcp-client/issues)
- [Wiki](https://github.com/RoboFinSystems/robosystems/wiki)
- [Projects](https://github.com/orgs/RoboFinSystems/projects)
- [Discussions](https://github.com/orgs/RoboFinSystems/discussions)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
MIT © 2026 RFS LLC