com.rationalbloks/mcp

Est-ce que com.rationalbloks/mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.rationalbloks/mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 64 outils

• bulk_create_graph_nodes≈ 371 tokens

  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 (unique string) and data (properties dict). Example: entity_type: "concept" nodes: [ {"entity_id": "quantum-mechanics-001", "data": {"name": "Quantum Mechanics", "field": "Physics"}}, {"entity_id": "wave-function-001", "data": {"name": "Wave Function", "field": "Physics"}}, {"entity_id": "superposition-001", "data": {"name": "Superposition", "field": "Physics"}} ]

  Paramètres, retour & exemple (4)

  Paramètres

  • nodes · array · requis
    List of nodes. Each: {entity_id: string, data: {properties}}
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key for all nodes
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "bulk_create_graph_nodes", "arguments": {"nodes": [], "project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• bulk_create_graph_relationships≈ 362 tokens

  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, to_id, and optional data (properties). Example: rel_type: "related_to" relationships: [ {"from_id": "quantum-mechanics-001", "to_id": "wave-function-001", "data": {"strength": "strong"}}, {"from_id": "quantum-mechanics-001", "to_id": "superposition-001", "data": {"strength": "strong"}} ]

  Paramètres, retour & exemple (4)

  Paramètres

  • rel_type · string · requis
    Relationship key for all relationships
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)
  • relationships · array · requis
    List of relationships. Each: {from_id, to_id, data?}

  Exemple d'appel

  {"name": "bulk_create_graph_relationships", "arguments": {"rel_type": "texte", "project_id": "texte", "relationships": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_graph_node≈ 316 tokens

  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 types and their fields. Example: entity_type: "person" entity_id: "alan-turing-001" data: {"name": "Alan Turing", "birth_year": 1912, "field": "Computer Science"} The entity_id is your unique identifier — use meaningful IDs for knowledge graphs.

  Paramètres, retour & exemple (5)

  Paramètres

  • data · object · requis
    Node properties matching the entity schema
  • entity_id · string · requis
    Unique identifier for the node
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key (e.g., 'person', 'concept')
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "create_graph_node", "arguments": {"data": {}, "entity_id": "texte", "project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_graph_project≈ 738 tokens

  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 "type" and optional "required": true (defaults to false). SCHEMA STRUCTURE: { "nodes": { "EntityName": { "description": "What this entity represents", "flat_labels": ["AdditionalLabel"], "schema": { "field_name": {"type": "string", "required": true}, "other_field": {"type": "integer"} } } }, "relationships": { "RELATIONSHIP_TYPE": { "from": "EntityName", "to": "OtherEntity", "cardinality": "MANY_TO_MANY", "data_schema": { "field_name": {"type": "date"} } } } } FIELD TYPES: string, integer, float, boolean, date, json CARDINALITY OPTIONS: ONE_TO_ONE, ONE_TO_MANY, MANY_TO_ONE, MANY_TO_MANY HIERARCHICAL NODES: nest an entity inside its parent entity (beside "description", "flat_labels" and "schema") to create a type hierarchy; the child inherits the parent's labels: "Animal": {"description": "...", "schema": {...}, "Dog": {"description": "...", "schema": {...}}} RULES: 1. "nodes" key is REQUIRED — must contain at least one entity 2. Each entity needs "description" and "schema" with field definitions 3. Each field is {"type": "...", "required": true/false} — required defaults to false 4. Relationship "from"/"to" must reference defined node names 5. Relationship types should be UPPER_SNAKE_CASE 6. Entity names should be PascalCase 7. Automatic fields (id, created_at, updated_at) are NOT needed WORKFLOW: 1. get_graph_template_schemas FIRST to see valid examples 2. create_graph_project with a cluster_id from list_clusters 3. Poll get_job_status with the returned job_id (2-5 minutes) While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (3)

  Paramètres

  • name · string · requis
    Project name
  • schema · object · requis
    Graph schema with 'nodes' and optionally 'relationships' keys. Use get_graph_template_schemas to see valid examples.
  • cluster_id · string · requis
    REQUIRED — BYOC resource pool ID (from list_clusters) to deploy this graph project onto your own cluster. Owned hosting is retired: a project we operate must run on your own infrastructure. Register a pool via the Resource Pools UI first, then pass its id here.

  Exemple d'appel

  {"name": "create_graph_project", "arguments": {"name": "texte", "schema": {}, "cluster_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_graph_relationship≈ 305 tokens

  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" from_id: "alan-turing-001" to_id: "on-computable-numbers-001" data: {"year": 1936} The from_id and to_id must be entity_ids of existing nodes.

  Paramètres, retour & exemple (6)

  Paramètres

  • data · object · optionnel
    Relationship properties (optional)
  • to_id · string · requis
    Target node entity_id
  • from_id · string · requis
    Source node entity_id
  • rel_type · string · requis
    Relationship key (e.g., 'authored', 'related_to')
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "create_graph_relationship", "arguments": {"to_id": "texte", "from_id": "texte", "rel_type": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_project≈ 705 tokens

  Create 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: {"orders": {"fields": {...}}} — never nest under 'fields' 2. EVERY field has a "type": string (MUST have max_length), text, integer, decimal (precision, scale), boolean, uuid, date, datetime (NOT "timestamp"), json, and the PostgreSQL arrays uuid_array, integer_array, text_array, float_array (GIN-indexed: @> contains, <@ contained_by, && overlaps) 3. AUTOMATIC FIELDS (DON'T define): id, created_at, updated_at, row_version 4. USERS: NEVER create users/customers/employees tables with email or password. Link to the built-in app_users table: {"user_id": {"type": "uuid", "foreign_key": "app_users.id"}}. A table with such a field is owner-scoped: each user sees their own rows. 5. FIELD OPTIONS: required, unique, default, enum, foreign_key ("table.id"), on_delete (cascade, set_null, restrict, no_action), nullable, index, description, write_only, computed. Advanced features (__policy__, computed columns, __constraints__, __audit__): get_schema_reference. BACKEND ENGINE (backend_type): "python" (FastAPI, default) or "rust" (Axum: faster cold starts, lower memory). WORKFLOW: 1. get_template_schemas FIRST to see valid examples 2. create_project with a cluster_id from list_clusters 3. Poll get_job_status with the returned job_id (2-5 minutes) 4. get_project_info gives the live URL While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · requis
    Project name
  • schema · object · requis
    JSON schema in FLAT format (table_name → field_name → properties). Every field MUST have a 'type' property. Use get_template_schemas to see valid examples.
  • cluster_id · string · requis
    REQUIRED — BYOC resource pool ID (from list_clusters) to deploy this project onto your own cluster. Owned hosting is retired: a project we operate must run on your own infrastructure. Register a pool via the Resource Pools UI first, then pass its id here.
  • backend_type · string · optionnel · python | rust
    Backend engine: 'python' (FastAPI, default) or 'rust' (Axum, faster). Default: python

  Exemple d'appel

  {"name": "create_project", "arguments": {"name": "texte", "schema": {}, "cluster_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_graph_node≈ 197 tokens

  Delete a node and all its relationships from a deployed graph project. ⚠️ This also removes all relationships connected to this node (DETACH DELETE).

  Paramètres, retour & exemple (4)

  Paramètres

  • entity_id · string · requis
    The node's entity_id
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key (e.g., 'person', 'concept')
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "delete_graph_node", "arguments": {"entity_id": "texte", "project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_graph_project≈ 207 tokens

  Delete 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 names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "delete_graph_project", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_graph_relationship≈ 190 tokens

  Delete a specific relationship by its internal ID. Use get_node_relationships to find relationship IDs.

  Paramètres, retour & exemple (4)

  Paramètres

  • rel_id · integer · requis
    Internal relationship ID (from get_node_relationships)
  • rel_type · string · requis
    Relationship key
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "delete_graph_relationship", "arguments": {"rel_id": 1, "rel_type": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_module≈ 182 tokens

  Remove 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • module_id · string · requis
    Module ID (list_modules)

  Exemple d'appel

  {"name": "delete_module", "arguments": {"module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_project≈ 198 tokens

  Delete 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; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "delete_project", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deploy_destructive≈ 335 tokens

  Deploy 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_staging, deploy_production, deploy_graph_staging, deploy_graph_production) refused the plan, naming its drops, and those drops are intended. The operation is ASYNCHRONOUS: poll the returned job_id with get_job_status. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (2)

  Paramètres

  • project_id · string · requis
    Project ID (UUID), relational or graph
  • environment · string · requis · staging | production
    staging (deploys the saved schema) or production (promotes staging)

  Exemple d'appel

  {"name": "deploy_destructive", "arguments": {"project_id": "texte", "environment": "staging"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deploy_graph_production≈ 279 tokens

  Promote 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 rounds or cuts its values (a decimal with a smaller scale or turned integer, a datetime turned date): deploy_destructive applies it, a tool of its own so a client asks before it runs. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "deploy_graph_production", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deploy_graph_staging≈ 351 tokens

  Deploy 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 with a job_id. Use get_job_status to monitor progress. Deployment typically takes 2-5 minutes. Use get_graph_project_info to verify deployment succeeded. A plan that drops data is refused, naming every table, field, entity or relationship it would drop, and every field whose type change rounds or cuts its values (a decimal with a smaller scale or turned integer, a datetime turned date): deploy_destructive applies it, a tool of its own so a client asks before it runs. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "deploy_graph_staging", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deploy_module≈ 491 tokens

  Deploy 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), builds it and serves it at the module_url the answer names; the project's CORS origins take the module in. A private repository needs the RationalBloks GitHub App installed on it. The operation is ASYNCHRONOUS: poll the returned job_id with get_job_status. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (9)

  Paramètres

  • git_ref · string · optionnel
    Branch, tag or commit SHA for this first build (default: the default branch head)
  • env_vars · object · optionnel
    Environment variables {NAME: value}, each value text
  • memory_mb · integer · optionnel
    Memory allocation (default: 128)
  • project_id · string · requis
    Project ID (UUID) the module belongs to
  • module_name · string · requis
    Display name
  • module_type · string · requis · frontblok | logicblok
    frontblok (a Vite frontend) or logicblok (a backend built from its Dockerfile)
  • cpu_millicores · integer · optionnel
    CPU allocation (default: 100)
  • dockerfile_path · string · optionnel
    Dockerfile path inside the repository (default: Dockerfile)
  • github_repo_url · string · requis
    https://github.com/<owner>/<repo>

  Exemple d'appel

  {"name": "deploy_module", "arguments": {"project_id": "texte", "module_name": "texte", "module_type": "frontblok", "github_repo_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deploy_production≈ 326 tokens

  Promote 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 is ASYNCHRONOUS: poll the returned job_id with get_job_status. A plan that drops data is refused, naming every table, field, entity or relationship it would drop, and every field whose type change rounds or cuts its values (a decimal with a smaller scale or turned integer, a datetime turned date): deploy_destructive applies it, a tool of its own so a client asks before it runs. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "deploy_production", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deploy_staging≈ 436 tokens

  Deploy 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_status with the job_id to monitor progress. Deployment typically takes 2-5 minutes depending on schema complexity. If deployment fails, read the job's error first: one that starts with 'RationalBloks platform error' is the platform's, not the schema's. Otherwise check: (1) Schema format is FLAT (no 'fields' nesting), (2) Every field has a 'type' property, (3) Foreign keys reference existing tables, (4) No PostgreSQL reserved words in table/field names. Use get_project_info to see if the deployment succeeded. A plan that drops data is refused, naming every table, field, entity or relationship it would drop, and every field whose type change rounds or cuts its values (a decimal with a smaller scale or turned integer, a datetime turned date): deploy_destructive applies it, a tool of its own so a client asks before it runs. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "deploy_staging", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• drop_schema_items≈ 392 tokens

  Drop 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": "is_clock"} A drop that cannot be applied (a table or field that is not there, a schema the deploy would refuse, such as a field another reads) refuses them all, naming it, and nothing is saved. The answer carries 'applied', 'diff', 'plan' and the new 'version'. WORKFLOW: 1. preview_schema_change with the same operations: check 'diff' and 'plan' 2. drop_schema_items (pass expected_version to be refused if someone else saved meanwhile) 3. deploy_staging refuses the plan and names its drops; deploy_destructive applies it, then get_job_status

  Paramètres, retour & exemple (3)

  Paramètres

  • operations · array · requis
    The drops: drop_table(table) and drop_field(table, field) operations, applied in order and all together.
  • project_id · string · requis
    Project ID (UUID)
  • expected_version · string · optionnel
    The 'version' a get_schema read answered. The drop is refused (409) when the saved schema changed since.

  Exemple d'appel

  {"name": "drop_schema_items", "arguments": {"operations": [], "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• freeze_module≈ 195 tokens

  Stop a module's pods (scale to 0), remembering how many it ran; unfreeze_module starts them again. Freezing a frozen module changes nothing. 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • module_id · string · requis
    Module ID (list_modules)

  Exemple d'appel

  {"name": "freeze_module", "arguments": {"module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• fulltext_search_graph≈ 337 tokens

  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 you don't know which property contains the answer. Example: query "quantum" searches name, description, summary, notes, and all other string fields. Returns nodes with _match_fields showing which properties matched. Optionally filter by entity_type to narrow results.

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Max results (default: 50, max: 500)
  • query · string · requis
    Search text (case-insensitive, min 2 chars)
  • offset · integer · optionnel
    Pagination offset (default: 0)
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · optionnel
    Entity key to filter by (optional — omit to search all types)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "fulltext_search_graph", "arguments": {"query": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_data_schema≈ 212 tokens

  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 keys (for create_graph_relationship, etc.). ⭐ USE THIS FIRST before creating nodes/relationships to know what entity_type and rel_type values are valid.

  Paramètres, retour & exemple (2)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "get_graph_data_schema", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_node≈ 194 tokens

  Get a specific node by its entity_id from a deployed graph project. Returns all node properties including created_at and updated_at timestamps.

  Paramètres, retour & exemple (4)

  Paramètres

  • entity_id · string · requis
    The node's entity_id
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key (e.g., 'person', 'concept')
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "get_graph_node", "arguments": {"entity_id": "texte", "project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_project_info≈ 140 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_graph_project_info", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_schema≈ 217 tokens

  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. The response also says whether this saved schema is the deployed one: saved_schema_deployed is true when the last deploy applied it, false when it was saved after the last deploy (undeployed_changes then lists what deploying it would change), and null when no deployed schema is on record.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_graph_schema", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_schema_at_version≈ 160 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • version · string · requis
    Commit SHA of the version to retrieve
  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_graph_schema_at_version", "arguments": {"version": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_statistics≈ 170 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "get_graph_statistics", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_template_schemas≈ 267 tokens

  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 field definitions), relationship configurations (from, to, cardinality, data_schema), and hierarchical entity nesting. Available templates: Start from Scratch (hierarchy, flat labels, every field type), Social Network (people, organizations, content, follows), Knowledge Graph (topic hierarchy, articles, authors, concepts), Product Catalog (products, categories, suppliers, reviews). Each entry's 'schema' goes to create_graph_project as is or adapted. TIP: Study these templates to understand the correct graph schema format before creating custom schemas.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_graph_template_schemas", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_graph_version_history≈ 140 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_graph_version_history", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_job_status≈ 306 tokens

  Check 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 stopped is failed within about three minutes, and a deploy can take up to 15 minutes. A module job names its module_code, and a completed module build's result names the image it built (its commit). If status is 'failed', read failure_side and error: 'customer' means the project's input is proven the cause (an invalid schema, data the new schema does not fit, a change the resource pool cannot hold), and error says what to change; 'platform' means no input of the project is known to cause it: report it to RationalBloks rather than changing the schema.

  Paramètres, retour & exemple (1)

  Paramètres

  • job_id · string · requis
    Job ID a create, deploy, promotion, rollback, deletion or module operation answered

  Exemple d'appel

  {"name": "get_job_status", "arguments": {"job_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_node_relationships≈ 245 tokens

  Get all relationships connected to a specific node. Supports direction filtering (incoming, outgoing, both) and relationship type filtering.

  Paramètres, retour & exemple (6)

  Paramètres

  • direction · string · optionnel
    Filter: incoming, outgoing, or both (default: both)
  • entity_id · string · requis
    The node's entity_id
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key of the node
  • environment · string · optionnel
    Environment: staging or production (default: staging)
  • rel_type_filter · string · optionnel
    Filter by relationship type (UPPER_SNAKE_CASE)

  Exemple d'appel

  {"name": "get_node_relationships", "arguments": {"entity_id": "texte", "project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_project≈ 96 tokens

  Get detailed information about a specific project

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_project", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_project_info≈ 297 tokens

  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 failed). TROUBLESHOOTING: If status is CrashLoopBackOff, the schema is likely in wrong format (nested 'fields' key or missing 'type' properties). Use get_schema to review current schema. If replicas show 0/2, the init container (migration runner) is failing. This is almost always a schema format issue. RETURNS THE LIVE API URL: staging.url and production.url carry the deployed base URL for each environment (append /docs for the interactive OpenAPI docs); github.url is the generated repository. create_project does NOT return a URL, so this is the tool to call once get_job_status reports the deployment finished.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_project_info", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_project_storage_usage≈ 139 tokens

  Get object-storage usage for a project: file count and bytes used against the plan limits.

  Paramètres, retour & exemple (2)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: production)

  Exemple d'appel

  {"name": "get_project_storage_usage", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_project_usage≈ 98 tokens

  Get resource usage metrics (CPU, memory) for a project

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_project_usage", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_schema≈ 428 tokens

  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 current schema before making updates, copy schema as template for new projects, verify schema structure after deployment, learn the correct schema format by example. The returned schema will be in FLAT format: {table_name: {field_name: {type, properties}}}. The response also says whether this saved schema is the deployed one: saved_schema_deployed is true when the last deploy applied it, false when it was saved after the last deploy (undeployed_changes then lists what deploying it would change), and null when no deployed schema is on record. A LARGE SCHEMA: pass tables or fields to read only the part you are about to change — the answer's 'version' is the whole schema's either way, so a slice is enough to patch it with patch_schema(expected_version=...).

  Paramètres, retour & exemple (3)

  Paramètres

  • fields · array · optionnel
    Read only these fields, each written 'table.field' (e.g. ["parameters.is_clock"]); their table's own keys come with them.
  • tables · array · optionnel
    Read only these tables, whole (e.g. ["parameters"]). A table the schema does not hold is refused.
  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_schema", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_schema_at_version≈ 122 tokens

  Get the schema as it was at a specific version/commit

  Paramètres, retour & exemple (2)

  Paramètres

  • version · string · requis
    Commit SHA of the version
  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_schema_at_version", "arguments": {"version": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_schema_reference≈ 292 tokens

  Get 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 whether adopting it is safe — it replaces creator-ownership per table and fails closed on a null link), computed columns (read-only values derived from other columns), __constraints__ (composite uniqueness, checked at commit when deferrable), __audit__ (append-only audit log), __admin_write__ (a table only admins write), how user foreign keys are attributed on create, reading many rows in one request with <field>__in=a,b,c (the values separated by commas only), deleting the rows a filter names with expected_count, and writes that state the row_version they read (If-Match on a route, if_version in a batch).

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_schema_reference", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_subscription_status≈ 79 tokens

  Get your subscription tier, limits, and usage

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_subscription_status", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_template_schemas≈ 254 tokens

  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 key relationships configured correctly, best practices for field naming and types. Available templates: Start from Scratch (every field type), Team Collaboration (workspaces, channels, messages, tasks), E-Commerce Store (customer profiles, products, orders and their line items, reviews, shipments). Each entry's 'schema' goes to create_project as is or adapted; its 'tables' notes say how each table is authorized. TIP: Study these templates to understand the correct schema format before creating custom schemas.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_template_schemas", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_user_info≈ 74 tokens

  Get information about the authenticated user

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_user_info", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_version_history≈ 155 tokens

  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 started, get commit SHA for rollback_project.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "get_version_history", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_clusters≈ 194 tokens

  List 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 cluster. Registering a pool is a UI action (create a bare Ubuntu box, authorise the key we generate, then we provision it into a cluster automatically) — this tool only lists pools you already registered, it never handles cluster credentials.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_clusters", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_graph_nodes≈ 220 tokens

  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).

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    Max results (default: 100, max: 1000)
  • offset · integer · optionnel
    Pagination offset (default: 0)
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key (e.g., 'person', 'concept')
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "list_graph_nodes", "arguments": {"project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_modules≈ 206 tokens

  List 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 it built: <name>:<short sha>-<build time>), replicas (live pods: 0 when frozen, null while the pool is not reporting), CPU and memory, and env_var_names (the names of its environment variables, never their values).

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "list_modules", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_project_files≈ 188 tokens

  List a project's uploaded files (metadata + public URLs), most recent first. Inspection only — files are not streamed through MCP.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Max files to return (1-1000, default 100)
  • offset · integer · optionnel
    Pagination offset (default 0)
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: production)

  Exemple d'appel

  {"name": "list_project_files", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_project_jobs≈ 258 tokens

  List 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 operation did when you no longer have its job_id (after an interruption, or in a later session): the first job of the job_type you want is the latest. Read older jobs a page at a time with offset; a page shorter than limit is the last.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max jobs to return (1-1000, default 100)
  • offset · integer · optionnel
    Jobs to skip, newest first (default 0)
  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "list_project_jobs", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_projects≈ 79 tokens

  List all your RationalBloks projects with their status and URLs

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_projects", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• patch_schema≈ 684 tokens

  Change 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 stays a rename and the column keeps its data. OPERATIONS (each one small object, applied in the order given): • {"op": "add_table", "table": "clocks", "definition": {...}} new table, same FLAT rules as create_project • {"op": "rename_table", "table": "clocks", "to": "timers"} • {"op": "add_field", "table": "assets", "field": "serial", "definition": {"type": "string", "max_length": 64}} • {"op": "rename_field", "table": "parameters", "field": "is_clock", "to": "clock_kind"} • {"op": "set_field", "table": "assets", "field": "name", "properties": {"max_length": 300}} merges; a property set to null is removed • {"op": "set_table", "table": "assets", "properties": {"__audit__": true}} __policy__, __constraints__, __audit__, __admin_write__ Dropping a table or field is drop_schema_items, a tool of its own. ALL OR NOTHING: an operation that cannot be applied — a table or field that is not there, a name already taken, a schema the deploy would refuse — refuses the whole patch, naming the operation, and nothing is saved. EVERY ANSWER IS A DIFF: 'applied' (what each operation did), 'diff' (every changed property by path), 'summary' and 'plan' (the migration a deploy would then run), and 'version' (the schema's version after the change). WORKFLOW: 1. get_schema with tables/fields to read the part you are changing (its 'version' is the whole schema's) 2. preview_schema_change with the operations: check 'diff' and 'plan' 3. patch_schema with the same operations (pass expected_version to be refused if someone else saved meanwhile) 4. deploy_staging, then get_job_status

  Paramètres, retour & exemple (3)

  Paramètres

  • operations · array · requis
    The operations, applied in order and all together. See the tool description for every op and its fields.
  • project_id · string · requis
    Project ID (UUID)
  • expected_version · string · optionnel
    The 'version' a get_schema read answered. The patch is refused (409) when the saved schema changed since, so two editors never overwrite each other silently.

  Exemple d'appel

  {"name": "patch_schema", "arguments": {"operations": [], "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• preview_schema_change≈ 353 tokens

  Preview 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 graph projects) ANSWER: 'applied' (for operations), 'diff' (every property saving it would change, by path), 'summary' and 'plan' (the migration the next deploy would then run, every table, field, entity or relationship it drops named), and 'version' (the saved schema's: pass it as expected_version to the save that follows, so it is refused if someone saved meanwhile). A relational schema the deploy would refuse is refused here, with the reason.

  Paramètres, retour & exemple (3)

  Paramètres

  • schema · object · optionnel
    A whole schema in place of the saved one (relational or graph). Pass this or operations.
  • operations · array · optionnel
    A change to part of a relational schema, as patch_schema or drop_schema_items take it. Pass this or schema.
  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "preview_schema_change", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• redeploy_module≈ 262 tokens

  Rebuild 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 the returned job_id with get_job_status, whose result names the image built (its commit); list_modules shows it once done. 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • module_id · string · requis
    Module ID (list_modules)

  Exemple d'appel

  {"name": "redeploy_module", "arguments": {"module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• redeploy_project≈ 320 tokens

  Rebuild 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 holds changes the last deploy did not apply (deploy_staging deploys those) or when nothing was deployed yet; a save that lands meanwhile is refused rather than deployed. deploy_production rebuilds production the same way when staging runs what production runs. The operation is ASYNCHRONOUS: poll the returned job_id with get_job_status. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • project_id · string · requis
    Project ID (UUID), relational or graph

  Exemple d'appel

  {"name": "redeploy_project", "arguments": {"project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rename_project≈ 120 tokens

  Rename a project (changes display name, not project_code)

  Paramètres, retour & exemple (2)

  Paramètres

  • name · string · requis
    New display name for the project
  • project_id · string · requis
    Project ID (UUID)

  Exemple d'appel

  {"name": "rename_project", "arguments": {"name": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rollback_graph_project≈ 288 tokens

  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 to. After rollback, the graph API will be redeployed with the old schema. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (3)

  Paramètres

  • version · string · requis
    Commit SHA to rollback to
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "rollback_graph_project", "arguments": {"version": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rollback_project≈ 299 tokens

  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 rollback, use get_job_status to monitor the redeployment. Rollback is useful when a schema change breaks deployment. One operation runs on a project at a time: while another runs, the call is refused and the refusal names the running job; wait for it with get_job_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (3)

  Paramètres

  • version · string · requis
    Commit SHA or version to rollback to
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "rollback_project", "arguments": {"version": "texte", "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• scale_module≈ 195 tokens

  Run 1 or 2 pods of a module (freeze_module stops it). 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (2)

  Paramètres

  • replicas · integer · requis · 1 | 2
    1 or 2 pods
  • module_id · string · requis
    Module ID (list_modules)

  Exemple d'appel

  {"name": "scale_module", "arguments": {"replicas": 1, "module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_graph_nodes≈ 310 tokens

  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"} (case-insensitive) Combined: entity_type: "person", filters: {"field": "~physics"} Without entity_type, searches ALL node types.

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Max results (default: 100, max: 1000)
  • offset · integer · optionnel
    Pagination offset (default: 0)
  • filters · object · requis
    Property filters. Prefix value with ~ for contains search.
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · optionnel
    Entity key to filter by (optional — omit to search all types)
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "search_graph_nodes", "arguments": {"filters": {}, "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_module_env≈ 340 tokens

  Set 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 and list_modules name the variables only. DESTRUCTIVE: a value replaced or removed cannot be read back. CORS_ORIGINS, DEPLOY_* and GITHUB_TOKEN are the platform's. The operation is a job: poll the returned job_id with get_job_status. 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (2)

  Paramètres

  • env_vars · object · requis
    {NAME: value} to set (text), {NAME: null} to remove; variables not named are kept
  • module_id · string · requis
    Module ID (list_modules)

  Exemple d'appel

  {"name": "set_module_env", "arguments": {"env_vars": {}, "module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_module_resources≈ 272 tokens

  Set a module's CPU and memory and rebuild it so its pods take them. The allocation is checked against the resource pool's capacity first; a refused one is restored. The operation is ASYNCHRONOUS: poll the returned job_id with get_job_status. 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (3)

  Paramètres

  • memory_mb · integer · requis
    Memory allocation in MB
  • module_id · string · requis
    Module ID (list_modules)
  • cpu_millicores · integer · requis
    CPU allocation in millicores

  Exemple d'appel

  {"name": "set_module_resources", "arguments": {"memory_mb": 1, "module_id": "texte", "cpu_millicores": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• traverse_graph≈ 409 tokens

  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 connections, discover clusters. Example: Start from "Alan Turing", traverse outgoing relationships up to 3 hops deep: start_entity_type: "person" start_entity_id: "alan-turing-001" max_depth: 3 direction: "outgoing" Supports filtering by relationship types and direction.

  Paramètres, retour & exemple (8)

  Paramètres

  • limit · integer · optionnel
    Max results (default: 100, max: 1000)
  • direction · string · optionnel
    Direction: outgoing, incoming, or both (default: both)
  • max_depth · integer · optionnel
    Maximum traversal depth (default: 3, max: 10)
  • project_id · string · requis
    Project ID (UUID)
  • environment · string · optionnel
    Environment: staging or production (default: staging)
  • start_entity_id · string · requis
    Entity ID of the starting node
  • start_entity_type · string · requis
    Entity key of the starting node
  • relationship_types · array · optionnel
    Filter by relationship types (UPPER_SNAKE_CASE). Omit for all types.

  Exemple d'appel

  {"name": "traverse_graph", "arguments": {"project_id": "texte", "start_entity_id": "texte", "start_entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• unfreeze_module≈ 188 tokens

  Start a frozen module's pods again, as many as it ran before the freeze. A running module is left as it is. 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 RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (1)

  Paramètres

  • module_id · string · requis
    Module ID (list_modules)

  Exemple d'appel

  {"name": "unfreeze_module", "arguments": {"module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_graph_node≈ 219 tokens

  Update properties of an existing node in a deployed graph project. Only send the fields you want to change — unspecified fields remain unchanged.

  Paramètres, retour & exemple (5)

  Paramètres

  • data · object · requis
    Properties to update (partial update)
  • entity_id · string · requis
    The node's entity_id
  • project_id · string · requis
    Project ID (UUID)
  • entity_type · string · requis
    Entity key (e.g., 'person', 'concept')
  • environment · string · optionnel
    Environment: staging or production (default: staging)

  Exemple d'appel

  {"name": "update_graph_node", "arguments": {"data": {}, "entity_id": "texte", "project_id": "texte", "entity_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_graph_schema≈ 402 tokens

  Replace 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 entity needs "description" and "schema" with field definitions • Each field is {"type": "...", "required": true/false} — required defaults to false • Relationships need "from", "to", and "cardinality" • Field types: string, integer, float, boolean, date, json • Relationship types should be UPPER_SNAKE_CASE • Entity names should be PascalCase WORKFLOW: 1. get_graph_schema to see the current schema (its 'version' pins the save) 2. preview_schema_change with the new schema: check 'diff' and 'plan' 3. update_graph_schema (pass expected_version to be refused if someone else saved meanwhile) 4. deploy_graph_staging, then get_job_status

  Paramètres, retour & exemple (3)

  Paramètres

  • schema · object · requis
    New graph schema with 'nodes' and optionally 'relationships' keys — the WHOLE schema.
  • project_id · string · requis
    Project ID (UUID)
  • expected_version · string · optionnel
    The 'version' a get_graph_schema read answered. The save is refused (409) when the saved schema changed since.

  Exemple d'appel

  {"name": "update_graph_schema", "arguments": {"schema": {}, "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_module≈ 237 tokens

  Rename 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_status, then call again. While RationalBloks is being updated, the call is refused with 'RationalBloks is being updated': call it again in a few minutes.

  Paramètres, retour & exemple (3)

  Paramètres

  • module_id · string · requis
    Module ID (list_modules)
  • module_name · string · optionnel
    New display name
  • github_repo_url · string · optionnel
    New repository, https://github.com/<owner>/<repo>

  Exemple d'appel

  {"name": "update_module", "arguments": {"module_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_schema≈ 497 tokens

  Replace 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 large schema to change one field risks changing something else on the way. ⚠️ Follow ALL rules from create_project: • FLAT format (no 'fields' nesting) • string: max_length (default 255) • decimal: precision + scale (default 10, 2) • Use "datetime" NOT "timestamp" • DON'T define: id, created_at, updated_at, row_version • NEVER create users/customers/employees tables (use app_users) ⚠️ MIGRATION RULES: • New fields MUST be "required": false OR have "default" value • Cannot add required field without default to existing tables WORKFLOW: 1. get_schema to see the current schema (its 'version' pins the save) 2. preview_schema_change with the new schema: check 'diff' and 'plan' 3. update_schema (pass expected_version to be refused if someone else saved meanwhile) 4. deploy_staging, then get_job_status A schema the deploy would refuse is refused here, and nothing is saved. The answer carries 'diff', 'plan' and the new 'version'.

  Paramètres, retour & exemple (3)

  Paramètres

  • schema · object · requis
    New JSON schema in FLAT format (table_name → field_name → properties) — the WHOLE schema. Every field MUST have a 'type' property.
  • project_id · string · requis
    Project ID (UUID)
  • expected_version · string · optionnel
    The 'version' a get_schema read answered. The save is refused (409) when the saved schema changed since, so two editors never overwrite each other silently.

  Exemple d'appel

  {"name": "update_schema", "arguments": {"schema": {}, "project_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://mcp.rationalbloks.com/