RationalBloks
What it does
Deploy production REST and Neo4j Graph APIs from JSON schemas in seconds.
- Connects パソコンでもクラウドでも
- Account or key Cloud: No key needed · Local: Needs RATIONALBLOKS_API_KEY
- Category 開発者ツール
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 4/5 合格 · 質問内容は提供元のサーバー(mcp.rationalbloks.com)を通ります · ✓ コマンド確認済み 2026年11月13日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげます · 約 2 分
キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
Claude の Connectors ページを開く
CustomizeConnectors
「Add」→「Custom」→「Web」を押し、この 2 つを入力
ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します
Name · 名前RationalBloksRemote MCP server URL · アドレスhttps://mcp.rationalbloks.com/Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します
チャットで有効にする
+ConnectorsRationalBloks
試してみる
RationalBloks を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が RationalBloks を使っていると言うか、回答に RationalBloks のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT との接続はプランしだい
フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ
Web 版 ChatGPT で MCP の追加ページを開く
Plugins+Add custom MCP server
名前とアドレスを入力
名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します
Name · 名前RationalBloksConnection · アドレスhttps://mcp.rationalbloks.com/チャットで RationalBloks を選ぶ
新しいチャットを開き、入力前にプラグインの一覧から RationalBloks を選びます
試してみる
RationalBloks を使って、私に何ができるか教えて、1 つやってみせて✓ ChatGPT が RationalBloks を使っていると言うか、回答に RationalBloks のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code につなげます · 約 2 分
キー不要、インストール不要
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --transport http --scope user rationalbloks https://mcp.rationalbloks.com/Claude Code で /mcp と入力
RationalBloks が一覧にあり、接続済みと表示されれば OK です
試してみる
RationalBloks を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が RationalBloks を使っていると言うか、回答に RationalBloks のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげます · 約 2 分
キー不要、インストール不要
Cursor の AI チャットを Agent モードで開く
試してみる
RationalBloks を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が RationalBloks を使っていると言うか、回答に RationalBloks のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげます · 約 2 分
キー不要、インストール不要
VS Code の AI チャットを Agent モードで開く
試してみる
RationalBloks を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が RationalBloks を使っていると言うか、回答に RationalBloks のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
Web 経由でつなぐアプリ用のアドレス
https://mcp.rationalbloks.com/JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
Web 経由
Claude Code
claude mcp add --transport http --scope user rationalbloks https://mcp.rationalbloks.com/Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"rationalbloks": {
"url": "https://mcp.rationalbloks.com/"
}
}
}VS Code (mcp.json)
{
"servers": {
"rationalbloks": {
"type": "http",
"url": "https://mcp.rationalbloks.com/"
}
}
}パソコンにインストール
Claude Code
claude mcp add --scope user rationalbloks --env RATIONALBLOKS_API_KEY=your-value -- uvx rationalbloks-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"rationalbloks": {
"command": "uvx",
"args": [
"rationalbloks-mcp"
],
"env": {
"RATIONALBLOKS_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"rationalbloks": {
"command": "uvx",
"args": [
"rationalbloks-mcp"
],
"env": {
"RATIONALBLOKS_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"rationalbloks": {
"type": "stdio",
"command": "uvx",
"args": [
"rationalbloks-mcp"
],
"env": {
"RATIONALBLOKS_API_KEY": "your-value"
}
}
}
}自分で入力する値
RATIONALBLOKS_API_KEY秘密 必須 envYour RationalBloks API key (get it from rationalbloks.com/settings)
説明は英語の原文のままです。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
インターネット経由でつなげるアプリ
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
ツールの名前と説明は、サーバーが2026年11月13日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。
list_projectsList all your RationalBloks projects with their status and URLs
get_projectGet detailed information about a specific project
get_schemaGet the JSON schema definition of a project in FLAT format. Returns the schema structure where each table name maps directly to field definitions. This is the same format required for create_project and update_schema. USE CASES: Review current schema before making updates, copy s
get_user_infoGet information about the authenticated user
list_clustersList your registered BYOC resource pools (client-owned Kubernetes clusters). Each returned cluster has an 'id' you MUST pass as create_project's cluster_id to deploy a project onto your own infrastructure — owned hosting is retired, so every project we operate runs on your own cl
get_job_statusCheck the status of a job (a create, deploy, promotion, rollback, deletion or module operation). STATUS VALUES: pending (queued), processing (in progress), completed (success), failed. Call it until the status is completed or failed: every job ends, since a job whose server stopp
list_project_jobsList a project's jobs, newest first: every create, deploy, promotion, rollback, resource change and module operation, each with its status, error, failure_side and when it started and ended. A job's record is kept for the life of the project, so this is how to find out what an op
get_project_infoGet detailed project info including deployment status and resource usage. DEPLOYMENT STATUS: Running (healthy), Pending (starting), CrashLoopBackOff (init container failed - usually schema format error), ImagePullBackOff (image build failed). TROUBLESHOOTING: If status is CrashLo
get_version_historyGet the deployment and version history (git commits) for a project. Shows all schema changes with commit SHA, timestamp, and message. USE CASES: Review what changed between deployments, find the last working version before issues started, get commit SHA for rollback_project.
get_template_schemasGet pre-built template schemas for common use cases. ⭐ USE THIS FIRST when creating a new project! Templates show the CORRECT schema format with: proper FLAT structure (no 'fields' nesting), every field has a 'type' property, foreign key relationships configured correctly, best p
get_schema_referenceGet the reference for ADVANCED schema features the templates do not show — read this before adding authorization or derived fields to a schema. Covers: __policy__ (relationship-based read/write authorization with single- and multi-hop membership paths, and the rules that decide w
get_subscription_statusGet your subscription tier, limits, and usage
get_project_usageGet resource usage metrics (CPU, memory) for a project
get_project_storage_usageGet object-storage usage for a project: file count and bytes used against the plan limits.
list_project_filesList a project's uploaded files (metadata + public URLs), most recent first. Inspection only — files are not streamed through MCP.
get_schema_at_versionGet the schema as it was at a specific version/commit
preview_schema_changePreview a schema change, saving nothing: the one way to see what a change would do before it is saved. Pass ONE of: • operations: the operations patch_schema or drop_schema_items would apply (relational projects) • schema: a whole schema in place of the saved one (relational or g
create_projectCreate a new RationalBloks project (a PostgreSQL REST API) from a JSON schema, on one of your resource pools. ⚠️ CRITICAL RULES - READ BEFORE CREATING SCHEMA: 1. FLAT FORMAT (REQUIRED): ✅ CORRECT: {"orders": {"total": {"type": "decimal", "precision": 10, "scale": 2}}} ❌ WRONG: {"
update_schemaReplace a project's WHOLE schema (saves to database, does NOT deploy). DESTRUCTIVE: a table or field the schema leaves out is dropped by the next deploy. For a new data model or a template. To change part of a schema use patch_schema, and drop_schema_items to drop; sending back a
patch_schemaChange PART of a project's schema without dropping any of it (saves to database, does NOT deploy). Send only the change. The server applies it to the saved schema, in order and all together, and keeps every table and field it does not touch — including their identity, so a rename
drop_schema_itemsDrop tables or fields from a project's saved schema (saves to database, does NOT deploy). DESTRUCTIVE: the next deploy drops their data. OPERATIONS (applied in order and all together): • {"op": "drop_table", "table": "clocks"} • {"op": "drop_field", "table": "parameters", "field"
deploy_stagingDeploy a project's saved schema to the staging environment. This triggers: (1) Schema validation, (2) Docker image build, (3) GitHub commit, (4) Kubernetes deployment, (5) Database migrations. The operation is ASYNCHRONOUS - it returns immediately with a job_id. Use get_job_statu
deploy_productionPromote staging to production (requires a paid plan): production's database migrates from the schema it runs to the one staging runs, and production runs staging's build. With staging unchanged since the last promotion, it rebuilds production with no schema change. The operation
deploy_destructiveDeploy a plan that drops data, of a relational or a graph project. DESTRUCTIVE: the tables, fields, entities or relationships the plan drops lose their data. environment 'staging' deploys the saved schema, 'production' promotes staging. Use it only after a deploy tool (deploy_sta
redeploy_projectRebuild and roll out a project's staging environment from the schema it runs, with NO schema change, for a relational or a graph project: the current platform release, the project's settings (email, admin users) and its environment take effect. Refused (409) when the saved schema
delete_projectDelete a project (removes GitHub repo, K8s deployments, and database). It runs as a job: poll the returned job_id with get_job_status until it is completed. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; w
rollback_projectRollback a project to a previous version. ⚠️ WARNING: This reverts schema AND code to the specified commit. Database data is NOT rolled back. Use get_version_history to find the commit SHA of the version you want to rollback to. After rollback, use get_job_status to monitor the r
rename_projectRename a project (changes display name, not project_code)
get_graph_schemaGet the graph schema definition of a project. Returns the hierarchical schema with nodes (entities) and relationships. Graph schemas define entity hierarchies and typed relationships — a different format than relational flat-table schemas. The response also says whether this save
get_graph_template_schemasGet pre-built graph template schemas for common use cases. ⭐ USE THIS FIRST when creating a new graph project! Templates show the CORRECT graph schema format with: proper node definitions (description, flat_labels, schema with flat field definitions), relationship configurations
get_graph_version_historyGet the deployment and version history for a graph project. Shows all schema changes with commit SHAs, timestamps, version numbers, and messages. Use this to find a specific version for rollback operations.
get_graph_schema_at_versionGet the graph schema as it existed at a specific version/commit. Use get_graph_version_history to find commit SHAs. Useful for comparing schemas across versions or auditing changes.
get_graph_project_infoGet detailed graph project information including Kubernetes deployment status, Neo4j database health, pod status, and resource usage. Use this after deployment to verify the graph project is running correctly.
create_graph_projectCreate a new Neo4j graph database project from a hierarchical JSON schema. ⚠️ GRAPH SCHEMA FORMAT — READ BEFORE CREATING: Graph schemas define nodes (entities) and relationships, NOT flat database tables. Each field is a dict with "type" and optional "required": true (defaults to
update_graph_schemaReplace a graph project's WHOLE schema (saves to database, does NOT deploy). DESTRUCTIVE: an entity, relationship or field the schema leaves out is deleted by the next deploy. ⚠️ Follow ALL rules from create_graph_project: • Must have "nodes" key with at least one entity • Each e
deploy_graph_stagingDeploy a graph project's saved schema to the staging environment. This triggers: (1) Schema validation, (2) Neo4j entity code generation, (3) Docker image build, (4) GitHub commit, (5) Kubernetes deployment with Neo4j instance. The operation is ASYNCHRONOUS — returns immediately
deploy_graph_productionPromote graph staging to production. Creates a separate production Neo4j instance with its own credentials and database. Requires paid plan. A plan that drops data is refused, naming every table, field, entity or relationship it would drop, and every field whose type change round
delete_graph_projectDelete a graph project (removes GitHub repo, K8s deployments, Neo4j database, and credentials). It runs as a job: poll the returned job_id with get_job_status until it is completed. One operation runs on a project at a time: while another runs, the call is refused and the refusal
rollback_graph_projectRollback a graph project to a previous version. ⚠️ WARNING: This reverts schema AND code to the specified commit. Neo4j data is NOT rolled back. Use get_graph_version_history to find the commit SHA of the version you want to rollback to. After rollback, the graph API will be rede
create_graph_nodeCreate a single node in a deployed graph project. REQUIRES: Project must be deployed (use deploy_graph_staging first). The entity_type must match an entity key from the project schema. Use get_graph_data_schema to see available entity types and their fields. Example: entity_type:
get_graph_nodeGet a specific node by its entity_id from a deployed graph project. Returns all node properties including created_at and updated_at timestamps.
list_graph_nodesList nodes of a specific entity type from a deployed graph project. Supports pagination with limit/offset. Returns nodes ordered by creation date (newest first).
update_graph_nodeUpdate properties of an existing node in a deployed graph project. Only send the fields you want to change — unspecified fields remain unchanged.
delete_graph_nodeDelete a node and all its relationships from a deployed graph project. ⚠️ This also removes all relationships connected to this node (DETACH DELETE).
create_graph_relationshipCreate a relationship between two nodes in a deployed graph project. The rel_type must match a relationship key from the project schema. Use get_graph_data_schema to see available relationship types. Example: rel_type: "authored" from_id: "alan-turing-001" to_id: "on-computable-n
get_node_relationshipsGet all relationships connected to a specific node. Supports direction filtering (incoming, outgoing, both) and relationship type filtering.
delete_graph_relationshipDelete a specific relationship by its internal ID. Use get_node_relationships to find relationship IDs.
bulk_create_graph_nodesCreate multiple nodes at once (up to 500 per call). Uses Neo4j UNWIND for high performance. Essential for knowledge graph population — create hundreds of entities from a single book chapter or article. Each node needs: entity_id (unique string) and data (properties dict). Example
bulk_create_graph_relationshipsCreate multiple relationships at once (up to 500 per call). Uses Neo4j UNWIND for high performance. Essential for connecting knowledge — link hundreds of concepts, people, and events in one operation. Each relationship needs: from_id, to_id, and optional data (properties). Exampl
search_graph_nodesSearch for nodes by property values in a deployed graph project. Supports exact match and contains search (prefix value with ~ for contains). Examples: Exact: filters: {"name": "Alan Turing"} Contains: filters: {"name": "~turing"} (case-insensitive) Combined: entity_type: "person
fulltext_search_graphSearch across ALL string properties of ALL nodes in a deployed graph using free-text queries. Unlike search_graph_nodes (which filters by specific property), this searches every text field at once. Perfect for finding knowledge when you don't know which property contains the answ
traverse_graphWalk the graph from a starting node, discovering connected knowledge. Returns all nodes reachable within max_depth hops, with their distance from the start. Essential for exploring knowledge graphs — find related concepts, trace connections, discover clusters. Example: Start from
get_graph_statisticsGet statistics about a deployed graph: total node count, total relationship count, counts per entity type, counts per relationship type. Essential for understanding the current state of a knowledge graph before adding more data.
get_graph_data_schemaGet the runtime schema of a DEPLOYED graph project — shows the actual entity types and relationship types available for data operations. Returns: Available entity keys (for create_graph_node, list_graph_nodes, etc.) and relationship keys (for create_graph_relationship, etc.). ⭐ U
list_modulesList a project's modules and what each runs: module_id (what every module tool takes), name, type (frontblok or logicblok), repository, url, staging_status (not_deployed, deploying, deployed, failed), deployed_at, image (the image of its last successful build, named by the commit
deploy_moduleDeploy a new module from a GitHub repository onto the project's resource pool: a frontblok module is a Vite frontend, a logicblok module a backend built from its Dockerfile that serves port 8000 with GET /health. Its job clones the repository (the default branch head, or git_ref)
redeploy_moduleRebuild a module from its repository's default branch head and roll it out, keeping its pod count. Its data and settings are untouched; the project's API (staging and production) and its backend modules restart to take the module's CORS origin. The operation is ASYNCHRONOUS: poll
update_moduleRename a module, or point it at another GitHub repository, which its next redeploy builds. Pass module_name, github_repo_url or both. One operation runs on a module at a time, and none beside an operation on its project: the refusal names the running job; wait for it with get_job
delete_moduleRemove a module: its pods stop and it leaves the project and its CORS origins. DESTRUCTIVE. One operation runs on a module at a time, and none beside an operation on its project: the refusal names the running job; wait for it with get_job_status, then call again. While RationalBl
set_module_envSet a module's environment variables: {NAME: value} sets one, {NAME: null} removes one, and every variable not named is kept. A backend module restarts to take them; a frontend module rebuilds (they are build arguments). Values are stored encrypted and never returned: the answer
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月14日にチェック
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの5863件のうち69%よりスターが多い
- このカテゴリのほかの5863件のうち91%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5863件のうち50%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
RationalBloksは安全ですか?
当てはまる基本チェック5項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:RATIONALBLOKS_API_KEY
パソコンで動きますか、それともクラウドですか?
どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は3 日前、最新バージョン(0.16.2)がレジストリに届いたのは3 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。
同じカテゴリのほかの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
RationalBloks MCP Server
Deploy production APIs in minutes. Tools for projects, schemas, deployments, modules, object storage, and graph data — delivered on infrastructure you own (self-host or your own BYOC cluster).
What Is This?
RationalBloks MCP lets AI agents (Claude Code, Claude Desktop, Cursor, VS Code, etc.) deploy production APIs from a JSON schema, and deploy and run the frontends and backends built on them. No backend code to write. No infrastructure to manage.
"Create a task management API with tasks, projects, and users"
→ 2-5 minutes later: the API runs on staging, on your Kubernetes cluster
Installation
# recommended — no install step; @latest checks for a new release at every start
uvx rationalbloks-mcp@latest
or install into an environment
pip install rationalbloks-mcp
Quick Start
1. Get Your API Key
Visit rationalbloks.com/settings and create an API key. A key carries scopes: a read key reaches only the read tools, a read + write key reaches every tool. The server lists only the tools your key may call.
2. Configure Your AI Agent
Claude Code — remote server (no install):
claude mcp add --transport http rationalbloks https://mcp.rationalbloks.com/mcp \
--header "Authorization: Bearer rb_sk_your_key_here"
or the local server:
claude mcp add --env RATIONALBLOKS_API_KEY=rb_sk_your_key_here rationalbloks \
-- uvx rationalbloks-mcp@latest
--scope project writes the server to the repository's .mcp.json instead, to share it with a team. Keep the key out of the file with "Authorization": "Bearer ${RATIONALBLOKS_API_KEY}": Claude Code expands the variable from each developer's environment.
VS Code — add to .vscode/mcp.json (Cursor: .cursor/mcp.json with a mcpServers key):
{
"servers": { "rationalbloks": { "command": "uvx", "args": ["rationalbloks-mcp@latest"], "env": { "RATIONALBLOKS_API_KEY": "rb_sk_your_key_here" } } } }
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": { "rationalbloks": { "command": "uvx", "args": ["rationalbloks-mcp@latest"], "env": { "RATIONALBLOKS_API_KEY": "rb_sk_your_key_here" } } } }
Any other client: point it at https://mcp.rationalbloks.com/mcp (Streamable HTTP) with Authorization: Bearer rb_sk_....
3. Claude Code Permissions
Every tool that can lose data carries destructiveHint: true, and no other tool can lose data. One allow rule covers the server, and ask rules keep a prompt on the tools that can lose data. Claude Code evaluates ask rules before allow rules, so they prompt even though the server is allowed, and in auto mode they still prompt, because they run before the classifier. Add this to .claude/settings.json (the project) or ~/.claude/settings.json (every project):
{
"permissions": { "allow": ["mcprationalbloks"], "ask": [ "mcprationalbloks__update_schema", "mcprationalbloksdrop_schema_items", "mcprationalbloksdeploy_destructive", "mcprationalbloksrollback_project", "mcprationalbloksdelete_project", "mcprationalbloksupdate_graph_schema", "mcprationalbloksrollback_graph_project", "mcprationalbloksdelete_graph_project", "mcprationalbloksdelete_graph_node", "mcprationalbloksdelete_graph_relationship", "mcprationalbloksset_module_env", "mcprationalbloksdelete_module" ] } }
Add "mcp__rationalbloks__deploy_production" to ask to approve each production release yourself.
Asked before every change: allow only the read tools instead. These rules match every read tool and no other:
{
"permissions": { "allow": [ "mcprationalbloksget_*", "mcprationalblokslist_*", "mcprationalblokssearch_graph_nodes", "mcprationalbloksfulltext_search_graph", "mcprationalblokstraverse_graph", "mcprationalblokspreview_schema_change" ] } }
Read-only server: register a second server with a read key. It lists only the read tools and the platform refuses every other call, so one rule allows all of it:
claude mcp add --transport http rationalbloks-read https://mcp.rationalbloks.com/mcp \
--header "Authorization: Bearer rb_sk_your_read_key"
{ "permissions": { "allow": ["mcp__rationalbloks-read"] } }
Auto mode reads autoMode only from ~/.claude/settings.json, managed settings or --settings, never from a project's .claude/settings.json. If its classifier blocks routine RationalBloks calls, describe your project there, keeping $defaults (replace MyProject and apps.yourdomain.com with your project's name and your cluster's domain):
{
"autoMode": { "environment": [ "$defaults", "Key internal services: RationalBloks (MCP server rationalbloks, https://mcp.rationalbloks.com), where our project MyProject runs; its staging environment is for development", "Trusted internal domains: rationalbloks.com and *.rationalbloks.com; *.apps.yourdomain.com, where MyProject's APIs and modules are served", "Sensitive remote targets: MyProject's production environment" ] } }
Run claude auto-mode config to see the rules in effect, or edit them in /permissions (Auto mode tab).
Tools
Read tools only read. Write tools change something, and never lose data. Destructive tools can lose data, and carry destructiveHint: true: they replace a whole schema (update_schema, update_graph_schema), drop, delete, roll back, deploy a plan that drops data (deploy_destructive), or overwrite a module's environment (set_module_env).
A plan drops data when it drops a table or field, or changes a field's type in a way that rounds or cuts its stored values (a decimal given a smaller scale or turned integer, a datetime turned date). The deploy tools refuse such a plan and name each drop; deploy_destructive applies it.
A long operation (create, deploy, rollback, delete, module operations) runs as a job: the tool answers a job_id, and get_job_status follows it to its result.
Relational Projects
| Tool | Kind | Description |
|---|---|---|
list_projects | read | List all your projects |
get_project | read | Get project details |
get_schema | read | Get the current JSON schema (optionally only some tables or fields) |
get_user_info | read | Get authenticated user info |
list_clusters | read | List your BYOC resource pools (client-owned clusters) |
get_job_status | read | Follow a job (create, deploy, promotion, rollback, deletion, module operation) to its result |
list_project_jobs | read | A project's jobs, newest first, each with its outcome |
get_project_info | read | Detailed project info with K8s status |
get_version_history | read | Git commit history |
get_template_schemas | read | Pre-built schema templates |
get_schema_reference | read | Advanced schema features reference (__policy__, computed, __constraints__, __audit__) |
get_subscription_status | read | Plan and usage limits |
get_project_usage | read | CPU/memory metrics |
get_project_storage_usage | read | Object-storage file count and bytes used vs limits |
list_project_files | read | List uploaded files (metadata + public URLs) |
get_schema_at_version | read | Schema at a specific commit |
preview_schema_change | read | Preview a change (patch operations or a whole schema): the migration plan and every drop, saving nothing |
create_project | write | Create a project from a schema (cluster_id of one of your BYOC pools; backend_type python or rust) |
patch_schema | write | Change part of the schema: add, rename and set tables and fields. Never drops |
deploy_staging | write | Deploy the saved schema to staging. Refuses a plan that drops data |
deploy_production | write | Promote staging to production. Refuses a plan that drops data |
redeploy_project | write | Rebuild and roll out staging from the schema it runs, with no schema change |
rename_project | write | Rename a project |
update_schema | destructive | Replace the whole schema: a table or field it leaves out is dropped by the next deploy |
drop_schema_items | destructive | Drop tables or fields from the saved schema |
deploy_destructive | destructive | Deploy a plan that drops data, to staging or production (relational or graph) |
rollback_project | destructive | Roll schema and code back to a previous version |
delete_project | destructive | Delete a project permanently |
Graph Projects
| Tool | Kind | Description |
|---|---|---|
get_graph_schema | read | Get a graph project's schema |
get_graph_template_schemas | read | Pre-built graph schema templates |
get_graph_version_history | read | Graph schema version history |
get_graph_schema_at_version | read | Schema at a specific version |
get_graph_project_info | read | Graph project info with K8s/Neo4j status |
create_graph_project | write | Create a Neo4j graph project |
deploy_graph_staging | write | Deploy the saved graph schema to staging. Refuses a plan that drops data |
deploy_graph_production | write | Promote graph staging to production. Refuses a plan that drops data |
update_graph_schema | destructive | Replace the whole graph schema: what it leaves out is dropped by the next deploy |
rollback_graph_project | destructive | Roll a graph project back to a previous version |
delete_graph_project | destructive | Delete a graph project |
Graph Data
| Tool | Kind | Description |
|---|---|---|
get_graph_node | read | Get a node by ID |
list_graph_nodes | read | List nodes by entity type |
get_node_relationships | read | Get a node's relationships |
search_graph_nodes | read | Search nodes by property filters |
fulltext_search_graph | read | Full-text search across all fields |
traverse_graph | read | Traverse the graph from a node |
get_graph_statistics | read | Graph statistics (counts) |
get_graph_data_schema | read | The deployed data schema |
create_graph_node | write | Create a node |
update_graph_node | write | Update node properties |
create_graph_relationship | write | Create a relationship |
bulk_create_graph_nodes | write | Create up to 500 nodes |
bulk_create_graph_relationships | write | Create up to 500 relationships |
delete_graph_node | destructive | Delete a node and its relationships |
delete_graph_relationship | destructive | Delete a relationship |
Modules
A module is one of a project's own frontends (frontblok) or backends (logicblok), built from a GitHub repository and run beside the project.
| Tool | Kind | Description |
|---|---|---|
list_modules | read | A project's modules: id, type, repository, URL, status, pods, resources, the image last built |
deploy_module | write | Deploy a new module from a GitHub repository |
redeploy_module | write | Rebuild a module from its repository's default branch head and roll it out |
| update_module | write | Rename a module or point it at anothe