# RationalBloks

By providing a simple JSON configuration file to describe your data structure, the system generates for you:

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add rationalbloks/rationalbloks

# Browse available tools
npx -y @smithery/cli@latest tool list rationalbloks/rationalbloks

# Get full schema for a tool
npx -y @smithery/cli@latest tool get rationalbloks/rationalbloks list_projects

# Call a tool
npx -y @smithery/cli@latest tool call rationalbloks/rationalbloks list_projects '{}'
```

## Direct MCP Connection

Endpoint: `https://rationalbloks--rationalbloks.run.tools`

**Required config:**
- `RATIONALBLOKS_API_KEY` (header) — Your RationalBloks API Key. Get it from infra.rationalbloks.com/settings

## Tools (18)

- `list_projects` — List all your RationalBloks projects with their status and URLs
- `get_project` — Get detailed information about a specific project
- `get_schema` — Get the JSON schema definition of a project
- `get_user_info` — Get information about the authenticated user
- `get_job_status` — Check the status of a deployment job
- `get_project_info` — Get detailed project info including deployment status and resource usage
- `get_version_history` — Get the deployment and version history (git commits) for a project
- `get_template_schemas` — Get available template schemas for creating new projects
- `get_subscription_status` — Get your subscription tier, limits, and usage
- `get_project_usage` — Get resource usage metrics (CPU, memory) for a project
- `get_schema_at_version` — Get the schema as it was at a specific version/commit
- `create_project` — Create a new RationalBloks project from a JSON schema
- `update_schema` — Update a project's schema (saves to database, does NOT deploy)
- `deploy_staging` — Deploy a project to the staging environment
- `deploy_production` — Promote staging to production (requires paid plan)
- `delete_project` — Delete a project (removes GitHub repo, K8s deployments, and database)
- `rollback_project` — Rollback a project to a previous version
- `rename_project` — Rename a project (changes display name, not project_code)

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get rationalbloks/rationalbloks <tool-name>
```

## Resources

- `rationalbloks://docs/getting-started` — Quick start guide for RationalBloks MCP server
- `rationalbloks://docs/schema-reference` — JSON schema format and field types reference
- `rationalbloks://docs/api-reference` — Complete MCP tool documentation

## Prompts (3)

- `create-crud-api` (data_model) — Create a full CRUD API project from a data model description
- `deploy-project` (project_name) — Deploy an existing project through staging to production
- `check-project-status` (project_name) — Get comprehensive status of a project including deployments and metrics