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

- **Type:** MCP server
- **Install:** `agentstack add mcp-robofinsystems-robosystems-mcp-client`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [RoboFinSystems](https://agentstack.voostack.com/s/robofinsystems)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [RoboFinSystems](https://github.com/RoboFinSystems)
- **Source:** https://github.com/RoboFinSystems/robosystems-mcp-client
- **Website:** https://robosystems.ai

## Install

```sh
agentstack add mcp-robofinsystems-robosystems-mcp-client
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## 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](https://github.com/RoboFinSystems)
- **Source:** [RoboFinSystems/robosystems-mcp-client](https://github.com/RoboFinSystems/robosystems-mcp-client)
- **License:** MIT
- **Homepage:** https://robosystems.ai

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-robofinsystems-robosystems-mcp-client
- Seller: https://agentstack.voostack.com/s/robofinsystems
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.