# RationalBloks

RationalBloks lets an AI agent deploy REST and Neo4j Graph APIs from JSON schemas on infrastructure you control. Use it to turn an API description into a deployed service.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: rationalbloks
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rationalbloks/rationalbloks-mcp
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/rationalbloks

## What it does

The MCP server exposes RationalBloks tools for projects, schemas, deployments, modules, object storage, and graph data. It can deploy APIs from JSON schemas, with hosting on infrastructure you own through self-hosting or your BYOC cluster. An API key is required.

The key’s scopes determine which tools appear: a read key exposes read operations, while a read-and-write key enables the full tool set. Operations that can remove data carry a destructive hint, and Claude Code permissions can ask for approval before those calls. Schema replacement and deletion can affect stored data, so configure permissions with care.

For a remote Claude Code connection, run `claude mcp add --transport http rationalbloks https://mcp.rationalbloks.com/`. Local setup uses `uvx rationalbloks-mcp`; the package can also be installed with `pip install rationalbloks-mcp`. Supported clients include Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.rationalbloks.com/`
- Environment variables: `RATIONALBLOKS_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.rationalbloks.com/
```

2. **Platform CLI**
```bash
claude mcp add --env RATIONALBLOKS_API_KEY=<RATIONALBLOKS_API_KEY> --transport stdio rationalbloks -- uvx rationalbloks-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from rationalbloks-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add rationalbloks --url https://mcp.rationalbloks.com/
```

2. **Platform CLI**
```bash
codex mcp add rationalbloks --env RATIONALBLOKS_API_KEY=<RATIONALBLOKS_API_KEY> -- uvx rationalbloks-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from rationalbloks-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rationalbloks": {
            "url": "https://mcp.rationalbloks.com/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rationalbloks": {
            "command": "uvx",
            "args": [
                "rationalbloks-mcp"
            ],
            "env": {
                "RATIONALBLOKS_API_KEY": "<RATIONALBLOKS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from rationalbloks-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rationalbloks": {
            "type": "http",
            "url": "https://mcp.rationalbloks.com/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rationalbloks": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "rationalbloks-mcp"
            ],
            "env": {
                "RATIONALBLOKS_API_KEY": "<RATIONALBLOKS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from rationalbloks-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http rationalbloks https://mcp.rationalbloks.com/
```

2. **Platform CLI**
```bash
gemini mcp add -e RATIONALBLOKS_API_KEY=<RATIONALBLOKS_API_KEY> rationalbloks uvx rationalbloks-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from rationalbloks-mcp <command>

## When to use it
- deploy a REST API from a JSON schema
- build a Neo4j Graph API
- let an agent inspect RationalBloks projects and schemas
- require approval for data-destructive operations

## Example prompts
- Create and deploy a REST API from this JSON schema for task tracking.
- Set up a Neo4j Graph API for links between projects and users.
- List my RationalBloks projects and inspect the current schema.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md