RationalBloks MCP Server

Deploy production APIs in minutes. 45 tools for projects, schemas, deployments, and graph data.

What Is This?

RationalBloks MCP lets AI agents (Claude, Cursor, etc.) deploy production APIs from a JSON schema. No backend code to write. No infrastructure to manage.

"Create a task management API with tasks, projects, and users"
→ 2 minutes later: Production API running on Kubernetes

Installation

pip install rationalbloks-mcp

Quick Start

1. Get Your API Key

Visit rationalbloks.com/settings and create an API key.

2. Configure Your AI Agent

VS Code / Cursor - Add to settings.json:

{
  "mcp.servers": {
    "rationalbloks": {
      "command": "rationalbloks-mcp",
      "env": {
        "RATIONALBLOKS_API_KEY": "rb_sk_your_key_here"
      }
    }
  }
}

Claude Desktop - Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rationalbloks": {
      "command": "rationalbloks-mcp",
      "env": {
        "RATIONALBLOKS_API_KEY": "rb_sk_your_key_here"
      }
    }
  }
}

45 Tools

Relational Read Operations (12 tools)

Tool	Description
`list_projects`	List all your projects
`get_project`	Get project details
`get_schema`	Get current JSON schema
`get_user_info`	Get authenticated user info
`get_job_status`	Check deployment job status
`get_project_info`	Detailed project info with K8s status
`get_version_history`	Git commit history
`get_template_schemas`	Pre-built schema templates
`get_subscription_status`	Plan and usage limits
`get_project_usage`	CPU/memory metrics
`get_schema_at_version`	Schema at specific commit
`list_clusters`	List your BYOC resource pools (client-owned clusters)

Relational Write Operations (7 tools)

Tool	Description
`create_project`	Create new project from schema
`update_schema`	Update project schema
`deploy_staging`	Deploy to staging environment
`deploy_production`	Deploy to production
`delete_project`	Delete project permanently
`rollback_project`	Rollback to previous version
`rename_project`	Rename project

Graph Schema Operations (11 tools)

Tool	Description
`get_graph_schema`	Get graph project schema
`get_graph_template_schemas`	Pre-built graph schema templates
`get_graph_version_history`	Graph schema version history
`get_graph_schema_at_version`	Schema at specific version
`get_graph_project_info`	Graph project info with K8s/Neo4j status
`create_graph_project`	Create Neo4j graph project
`update_graph_schema`	Update graph schema
`deploy_graph_staging`	Deploy graph to staging
`deploy_graph_production`	Deploy graph to production
`delete_graph_project`	Delete graph project
`rollback_graph_project`	Rollback graph to previous version

Graph Data Operations (15 tools)

Tool	Description
`create_graph_node`	Create a single node
`get_graph_node`	Get node by ID
`list_graph_nodes`	List nodes by entity type
`update_graph_node`	Update node properties
`delete_graph_node`	Delete a node
`create_graph_relationship`	Create a relationship
`get_node_relationships`	Get node's relationships
`delete_graph_relationship`	Delete a relationship
`bulk_create_graph_nodes`	Bulk create nodes
`bulk_create_graph_relationships`	Bulk create relationships
`search_graph_nodes`	Search nodes by property filters
`fulltext_search_graph`	Full-text search across all fields
`traverse_graph`	Traverse graph from a node
`get_graph_statistics`	Get graph statistics (counts)
`get_graph_data_schema`	Get deployed data schema

Schema Format

Schemas must be in FLAT format:

{
  "tasks": {
    "title": {"type": "string", "max_length": 200, "required": true},
    "status": {"type": "string", "max_length": 50, "enum": ["pending", "done"]},
    "due_date": {"type": "date", "required": false}
  },
  "projects": {
    "name": {"type": "string", "max_length": 100, "required": true}
  }
}

Field Types

Type	Required Properties
`string`	`max_length`
`text`	None
`integer`	None
`decimal`	`precision`, `scale`
`boolean`	None
`uuid`	None
`date`	None
`datetime`	None
`json`	None

Auto-Generated Fields

These are automatic - don't define them:

id (UUID primary key)
created_at (datetime)
updated_at (datetime)

User Authentication

Use the built-in app_users table:

{
  "employee_profiles": {
    "user_id": {"type": "uuid", "foreign_key": "app_users.id", "required": true},
    "department": {"type": "string", "max_length": 100}
  }
}

Frontend

For frontend development, use our NPM packages:

npm install @rationalbloks/frontblok-auth @rationalbloks/frontblok-crud

These provide:

frontblok-auth: Authentication, login, tokens, user context
frontblok-crud: Generic CRUD via getApi().getAll(), getApi().create(), etc.

Environment Variables

Variable	Description	Default
`RATIONALBLOKS_API_KEY`	Your API key (required)	-
`RATIONALBLOKS_TIMEOUT`	Request timeout (seconds)	`30`
`RATIONALBLOKS_LOG_LEVEL`	Log level	`INFO`

Support

Documentation: rationalbloks.com/docs
Email: support@rationalbloks.com

License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rationalbloks_mcp-0.11.0.tar.gz (27.8 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

rationalbloks_mcp-0.11.0-py3-none-any.whl (32.1 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file rationalbloks_mcp-0.11.0.tar.gz.

File metadata

Download URL: rationalbloks_mcp-0.11.0.tar.gz
Upload date: Aug 19, 2026
Size: 27.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for rationalbloks_mcp-0.11.0.tar.gz
Algorithm	Hash digest
SHA256	`96a65d9279b1a3dde5d3d1ca06fcd99c91bf576cc61e9358ec27c93335a851d3`
MD5	`142e95d6e08c5398d996f15bdecc8c13`
BLAKE2b-256	`6ac5bb0e6e1b989b937fa3e842d41908ee877e4d3b01e4ce2301e12fc0758a88`

See more details on using hashes here.

File details

Details for the file rationalbloks_mcp-0.11.0-py3-none-any.whl.

File metadata

Download URL: rationalbloks_mcp-0.11.0-py3-none-any.whl
Upload date: Aug 19, 2026
Size: 32.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for rationalbloks_mcp-0.11.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`8a0bfed1e83fd5f0415d07e1e834557ed995a3779900511b62bdf07a530eec7a`
MD5	`463aa8264fc74d0f0f1a91551c62e58f`
BLAKE2b-256	`29d655c55622b255934be25860bc9bae6e44cb57c70675b31c48add7e1792046`