RationalBloks

RationalBloks MCP Server

Deploy production APIs in minutes. 47 tools for projects, schemas, deployments, object storage, 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"
      }
    }
  }
}

---

47 Tools

Relational Read Operations (14 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_project_storage_usage	Object-storage file count and bytes used vs limits
list_project_files	List uploaded files (metadata + public URLs)
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

Proprietary - Copyright 2026 RationalBloks. All Rights Reserved.