RationalBloks MCP Server

Deploy production APIs in minutes. 18 tools for projects, schemas, and deployments.

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"
      }
    }
  }
}

18 Tools

Read Operations (11 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

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

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

RationalBloks

Quick Install