RationalBloks
io.github.rationalbloks/rationalbloks-mcp · v0.6.1 · MCP 2025-11-25
Deploy production REST APIs from JSON schemas in seconds. Manage projects, schemas, and deployments.
Reachability
reachable
checked 2026-07-14 03:45 UTC
Registry status active
Tools pinned 44
1037d6c0d4de
Tools last changed
unchanged since first capture 2026-07-14
Provenance
Registry namespace io.github.rationalbloks
(GitHub-account verified by the official registry)
Repository
github.com/rationalbloks/rationalbloks-mcp
Remote endpoints
https://mcp.rationalbloks.com/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-07-14 03:45 | first capture | 44 tools pinned |
Pinned tool definitions (44)
| Tool | Description |
|---|---|
| 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 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... |
| get_user_info | Get information about the authenticated user |
| get_job_status | Check the status of a deployment job. STATUS VALUES: pending (job queued), running (deployment in progress), completed (success), failed (deployment failed). TIMELINE: Typical deployment takes 2-5 minutes. If status is 'running' for >10... |
| get_project_info | Get 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... |
| get_version_history | Get 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... |
| get_template_schemas | Get 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... |
| 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. ⚠️ CRITICAL RULES - READ BEFORE CREATING SCHEMA: 1. FLAT FORMAT (REQUIRED): ✅ CORRECT: {users: {email: {type: "string", max_length: 255}}} ❌ WRONG: {users: {fields: {email:... |
| update_schema | Update a project's schema (saves to database, does NOT deploy). ⚠️ CRITICAL: Follow ALL rules from create_project: • FLAT format (no 'fields' nesting) • string: MUST have max_length • decimal: MUST have precision + scale • Use... |
| deploy_staging | Deploy a project 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... |
| 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. ⚠️ 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... |
| rename_project | Rename a project (changes display name, not project_code) |
| get_graph_schema | Get 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. |
| get_graph_template_schemas | Get 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... |
| get_graph_version_history | Get 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_version | Get 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_info | Get 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_project | Create 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... |
| update_graph_schema | Update a graph project's schema (saves to database, does NOT deploy). ⚠️ Follow ALL rules from create_graph_project: • Must have "nodes" key with at least one entity • Each entity needs "description" and "schema" with field... |
| deploy_graph_staging | Deploy a graph project 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... |
| deploy_graph_production | Promote graph staging to production. Creates a separate production Neo4j instance with its own credentials and database. Requires paid plan. |
| delete_graph_project | Delete a graph project (removes GitHub repo, K8s deployments, Neo4j database, and credentials) |
| rollback_graph_project | Rollback 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... |
| create_graph_node | Create 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... |
| get_graph_node | Get 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_nodes | List 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_node | Update properties of an existing node in a deployed graph project. Only send the fields you want to change — unspecified fields remain unchanged. |
| delete_graph_node | Delete a node and all its relationships from a deployed graph project. ⚠️ This also removes all relationships connected to this node (DETACH DELETE). |
| create_graph_relationship | Create 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" ... |
| get_node_relationships | Get all relationships connected to a specific node. Supports direction filtering (incoming, outgoing, both) and relationship type filtering. |
| delete_graph_relationship | Delete a specific relationship by its internal ID. Use get_node_relationships to find relationship IDs. |
| bulk_create_graph_nodes | Create 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... |
| bulk_create_graph_relationships | Create 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,... |
| search_graph_nodes | Search 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"}... |
| fulltext_search_graph | Search 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... |
| traverse_graph | Walk 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... |
| get_graph_statistics | Get 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_schema | Get 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... |
Status badge
[](https://toolpin.dev/servers/io.github.rationalbloks/rationalbloks-mcp)
Maintain this server? Add the badge to your README — it links your users to this live status page.