POST https://basile.lab.bray-numerique.fr/_mcp

Response
200 OK
IP
51.83.77.98
Profiled on
Token
b56a37

MCP Capabilities

19 Tools
0 Prompts
0 Resources
0 Resource Templates

Tools 19

update_preset

Description: Update an existing Synapse model preset (looked up by key). Only generation parameters and metadata are editable here — provider and model are NOT mutable (create a new preset instead). Any parameter left null is left unchanged. Returns the updated preset snapshot.

Parameters

Name Type Required Default Description
key string Yes - -
name null|string No -
generationTemperature null|number No -
generationTopP null|number No -
generationMaxOutputTokens null|integer No -
streamingEnabled null|boolean No -
isActive null|boolean No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:7 [
    "key" => array:1 [
      "type" => "string"
    ]
    "name" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "generationTemperature" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "number"
      ]
      "default" => null
    ]
    "generationTopP" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "number"
      ]
      "default" => null
    ]
    "generationMaxOutputTokens" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "integer"
      ]
      "default" => null
    ]
    "streamingEnabled" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => null
    ]
    "isActive" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => null
    ]
  ]
  "required" => array:1 [
    0 => "key"
  ]
]

update_agent

Description: Update the editable metadata of an existing Synapse agent (looked up by agentKey). Editable fields: name, emoji, description, modelPresetKey, allowedToolNames (comma-separated list, empty string for no restriction), isActive. To modify the systemPrompt use update_agent_system_prompt which has a dedicated HITL workflow. Parameters left null are left unchanged.

Parameters

Name Type Required Default Description
agentKey string Yes - -
name null|string No -
emoji null|string No -
description null|string No -
modelPresetKey null|string No -
allowedToolNames null|string No -
isActive null|boolean No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:7 [
    "agentKey" => array:1 [
      "type" => "string"
    ]
    "name" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "emoji" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "description" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "modelPresetKey" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "allowedToolNames" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "isActive" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => null
    ]
  ]
  "required" => array:1 [
    0 => "agentKey"
  ]
]

delete_preset

Description: Delete a Synapse model preset (looked up by key). By default refuses to delete if at least one agent explicitly references this preset, and returns the list of blocking agents. Pass force=true to bypass the reference check (use with caution — orphaned agents will fall back to the global active preset).

Parameters

Name Type Required Default Description
key string Yes - -
force null|boolean No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:2 [
    "key" => array:1 [
      "type" => "string"
    ]
    "force" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => false
    ]
  ]
  "required" => array:1 [
    0 => "key"
  ]
]

cleanup_sandbox

Description: Delete all sandbox (temporary) entities: workflow runs, workflows, agents, and presets. Safe to call multiple times (idempotent). Debug logs are preserved.

Parameters

Name Type Required Default Description

Full Schema

array:2 [
  "type" => "object"
  "properties" => {#860}
]

list_presets

Description: List all available Synapse model presets with their configuration (provider, model, generation params). Use includeSandbox=true to also see temporary sandbox presets.

Parameters

Name Type Required Default Description
includeSandbox null|boolean No -

Full Schema

array:2 [
  "type" => "object"
  "properties" => array:1 [
    "includeSandbox" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => false
    ]
  ]
]

delete_workflow

Description: Delete a Synapse workflow (looked up by workflowKey). Builtin workflows cannot be deleted. By default refuses to delete if the workflow is still referenced as a façade by at least one active agent (workflowKey column on SynapseAgent). Pass force=true to bypass the active-agent check (still forbids builtin deletion).

Parameters

Name Type Required Default Description
workflowKey string Yes - -
force null|boolean No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:2 [
    "workflowKey" => array:1 [
      "type" => "string"
    ]
    "force" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => false
    ]
  ]
  "required" => array:1 [
    0 => "workflowKey"
  ]
]

list_models

Description: List all LLM models declared in Synapse provider YAML catalogs (Google Vertex AI, OVH, Anthropic, etc.), grouped by provider. Each model entry exposes : - modelId, label, provider, isEnabled, inDb (true if a row exists in synapse_model) - pricing : { input, output, outputImage, currency } (per 1M tokens) - capabilities : textGeneration, embedding, imageGeneration, thinking, functionCalling, parallelToolCalls, responseSchema, streaming, systemPrompt, safetySettings, topK, vision, acceptedMimeTypes (list of MIME types) - limits : maxInputTokens, maxOutputTokens, contextWindow - embeddingDimensions (only for embedding models) - providerRegions (Vertex AI regions where the model is available) - rgpdRisk (RGPD risk classification, if known) - deprecatedAt (ISO date if the model is scheduled for deprecation) The enabled state is computed by overlaying the synapse_model table (admin overrides) on top of the YAML defaults : a model absent from the table is enabled by default ; a model present with isEnabled=false is disabled. Use providerFilter to restrict the output to a single provider slug. Read-only — to toggle a model use the admin UI.

Parameters

Name Type Required Default Description
providerFilter null|string No -

Full Schema

array:2 [
  "type" => "object"
  "properties" => array:1 [
    "providerFilter" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
  ]
]

list_agents

Description: List all available Synapse agents (DB + code) with their configuration. Use includeSandbox=true to also see temporary sandbox agents.

Parameters

Name Type Required Default Description
includeSandbox null|boolean No -

Full Schema

array:2 [
  "type" => "object"
  "properties" => array:1 [
    "includeSandbox" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => false
    ]
  ]
]

update_workflow

Description: Update an existing Synapse workflow (looked up by workflowKey). Editable fields: name, description, definition (full JSON of the steps pivot), isActive, sortOrder. The definition (if provided) must be a valid JSON object containing a non-empty `steps` array, each step having at least `name` and `type`. Parameters left null are left unchanged. The workflow version is bumped automatically when the definition changes.

Parameters

Name Type Required Default Description
workflowKey string Yes - -
name null|string No -
description null|string No -
definition null|string No -
isActive null|boolean No -
sortOrder null|integer No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:6 [
    "workflowKey" => array:1 [
      "type" => "string"
    ]
    "name" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "description" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "definition" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "isActive" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => null
    ]
    "sortOrder" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "integer"
      ]
      "default" => null
    ]
  ]
  "required" => array:1 [
    0 => "workflowKey"
  ]
]

update_agent_system_prompt

Description: Propose a new system prompt for a Synapse agent. By default the proposal enters the HITL pending queue (Guardrail #3) and requires human approval. Pass mode="live" to apply immediately (not recommended for automated callers).

Parameters

Name Type Required Default Description
agentId string Yes - -
systemPrompt string Yes - -
reason null|string No -
mode string No pending -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:4 [
    "agentId" => array:1 [
      "type" => "string"
    ]
    "systemPrompt" => array:1 [
      "type" => "string"
    ]
    "reason" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "mode" => array:2 [
      "type" => "string"
      "default" => "pending"
    ]
  ]
  "required" => array:2 [
    0 => "agentId"
    1 => "systemPrompt"
  ]
]

create_sandbox_agent

Description: Create a temporary (sandbox) agent for testing. The agent is immediately resolvable by AgentResolver. Use list_presets to find available preset keys, or create one with create_sandbox_preset. Sandbox agents are cleaned up by cleanup_sandbox.

Parameters

Name Type Required Default Description
key string Yes - -
name string Yes - -
systemPrompt string Yes - -
description null|string No -
presetKey null|string No -
allowedToolNames null|string No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:6 [
    "key" => array:1 [
      "type" => "string"
    ]
    "name" => array:1 [
      "type" => "string"
    ]
    "systemPrompt" => array:1 [
      "type" => "string"
    ]
    "description" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "presetKey" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "allowedToolNames" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
  ]
  "required" => array:3 [
    0 => "key"
    1 => "name"
    2 => "systemPrompt"
  ]
]

run_agent_test

Description: Execute any Synapse agent (DB or code) and return the response with metrics. Use list_agents to get available agent keys.

Parameters

Name Type Required Default Description
agentKey string Yes - -
input string Yes - -
userId null|integer No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:3 [
    "agentKey" => array:1 [
      "type" => "string"
    ]
    "input" => array:1 [
      "type" => "string"
    ]
    "userId" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "integer"
      ]
      "default" => null
    ]
  ]
  "required" => array:2 [
    0 => "agentKey"
    1 => "input"
  ]
]

create_sandbox_preset

Description: Create a temporary (sandbox) model preset for testing. Choose a provider and model from the known models list. Use list_presets to see existing presets. Sandbox presets are cleaned up by cleanup_sandbox.

Parameters

Name Type Required Default Description
key string Yes - -
name string Yes - -
providerName string Yes - -
model string Yes - -
temperature null|number No -
topP null|number No -
maxOutputTokens null|integer No -
streamingEnabled null|boolean No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:8 [
    "key" => array:1 [
      "type" => "string"
    ]
    "name" => array:1 [
      "type" => "string"
    ]
    "providerName" => array:1 [
      "type" => "string"
    ]
    "model" => array:1 [
      "type" => "string"
    ]
    "temperature" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "number"
      ]
      "default" => null
    ]
    "topP" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "number"
      ]
      "default" => null
    ]
    "maxOutputTokens" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "integer"
      ]
      "default" => null
    ]
    "streamingEnabled" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => null
    ]
  ]
  "required" => array:4 [
    0 => "key"
    1 => "name"
    2 => "providerName"
    3 => "model"
  ]
]

run_workflow

Description: Execute a workflow via WorkflowRunner. This triggers MultiAgent which calls AgentResolver for each step, enabling nested agent calls and full traceability. Returns the workflow run ID, outputs, and token usage.

Parameters

Name Type Required Default Description
workflowKey string Yes - -
inputs null|string No -
message null|string No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:3 [
    "workflowKey" => array:1 [
      "type" => "string"
    ]
    "inputs" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
    "message" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
  ]
  "required" => array:1 [
    0 => "workflowKey"
  ]
]

delete_agent

Description: Delete a Synapse agent (looked up by agentKey). Builtin (code) agents cannot be deleted. By default refuses to delete if the agent is referenced by at least one active workflow, and returns the blocking workflows. Pass force=true to bypass the active-workflow check (still forbids builtin deletion).

Parameters

Name Type Required Default Description
agentKey string Yes - -
force null|boolean No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:2 [
    "agentKey" => array:1 [
      "type" => "string"
    ]
    "force" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => false
    ]
  ]
  "required" => array:1 [
    0 => "agentKey"
  ]
]

create_sandbox_workflow

Description: Create a temporary workflow that chains agents into a multi-step pipeline. The definition must follow the pivot format: {"version":1,"steps":[{"name":"...","agent_name":"...","input_mapping":{...},"output_key":"..."}],"outputs":{...}}. All referenced agent_names must be resolvable. Cleaned up by cleanup_sandbox.

Parameters

Name Type Required Default Description
workflowKey string Yes - -
name string Yes - -
definition string Yes - -
description null|string No -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:4 [
    "workflowKey" => array:1 [
      "type" => "string"
    ]
    "name" => array:1 [
      "type" => "string"
    ]
    "definition" => array:1 [
      "type" => "string"
    ]
    "description" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "string"
      ]
      "default" => null
    ]
  ]
  "required" => array:3 [
    0 => "workflowKey"
    1 => "name"
    2 => "definition"
  ]
]

inspect_agent_debug

Description: Inspect debug log for an agent execution. Shows system prompt, pipeline, tokens, and full execution trace.

Parameters

Name Type Required Default Description
debugId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "debugId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "debugId"
  ]
]

list_workflows

Description: List all Synapse workflows with their metadata (name, description, version, active/builtin/sandbox flags, steps count). By default excludes sandbox workflows — pass includeSandbox=true to also see temporary ones. Use inspect_workflow_run to see execution history for a specific workflow.

Parameters

Name Type Required Default Description
includeSandbox null|boolean No -

Full Schema

array:2 [
  "type" => "object"
  "properties" => array:1 [
    "includeSandbox" => array:2 [
      "type" => array:2 [
        0 => "null"
        1 => "boolean"
      ]
      "default" => false
    ]
  ]
]

inspect_workflow_run

Description: Inspect a completed or failed workflow run. Shows status, step progression, input/output, tokens, duration, and error details. Use the workflowRunId returned by run_workflow.

Parameters

Name Type Required Default Description
workflowRunId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "workflowRunId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "workflowRunId"
  ]
]

Prompts 0

No prompts were registered.

Resources 0

No resources were registered.

Resource Templates 0

No resource templates were registered.