RationalBloks

RationalBloks MCP Server enables AI agents to deploy production APIs from a JSON schema with no backend code to write and no infrastructure to manage. It exposes a collection of tools you can call to create, deploy, query, and manage your APIs directly from your preferred MCP client.

How to use

You use this MCP server by connecting your MCP client to the local or configured runtime that executes the server process. The most common setup is to run the MCP runner from your editor or assistant and supply your API key to authenticate. Once connected, you can list projects, create new projects from schemas, deploy to staging or production, and monitor deployment status and usage through the available tools.

How to install

Prerequisites: ensure you have Python and pip installed on your system.

pip install rationalbloks-mcp

Configure your MCP client and API key

Obtain your API key from your RationalBloks account settings. Then configure your MCP client to use the server and key as shown in the examples.

# VS Code / Cursor example
{
  "mcp.servers": {
    "rationalbloks": {
      "command": "rationalbloks-mcp",
      "env": {
        "RATIONALBLOKS_API_KEY": "rb_sk_your_key_here"
      }
    }
  }
}

Run and test the server

Start using your MCP client to connect to the RationalBloks MCP Server. Pass your API key in the environment as shown above. From your client, you can begin by inspecting your projects, checking deployment status, and progressively deploying schemas to staging or production.

If you use Claude Desktop, apply the corresponding configuration with the same command and environment variable.

Note on environment variables

The server relies on environment variables to authenticate and tune behavior. The key variables are described in the environment section below. Ensure you securely store your API key and do not hard-code it in shared files.

Available tools

list_projects

List all projects in your RationalBloks account and workspace.

get_project

Retrieve details for a specific project.

get_schema

Fetch the current JSON schema for a project.

get_user_info

Obtain information about the authenticated user.

get_job_status

Check the status of a deployment job.

get_project_info

Get detailed information about a project, including Kubernetes status.

get_version_history

Retrieve the Git commit history related to a project.

get_template_schemas

Access pre-built schema templates for quick starts.

get_subscription_status

Check plan and usage limits for your account.

get_project_usage

View CPU and memory metrics for a project.

get_schema_at_version

Get the schema at a specific commit version.

create_project

Create a new project from a provided schema.

update_schema

Update the schema for an existing project.

deploy_staging

Deploy the current schema to a staging environment.

deploy_production

Deploy the current schema to production.

delete_project

Permanently delete a project.

rollback_project

Rollback a project to a previous version.

rename_project

Rename an existing project.