Verifies a Model Context Protocol (MCP) connection and discovers available tools.
Use this endpoint to test MCP server connectivity before configuring an agent.
MCP enables agents to connect to external services and data sources through a standardized protocol.
Verify connections before configuring them on agents to ensure proper connectivity and tool discovery.
Optional agent the connection belongs to. When set, the outcome is saved as the connection's latest test result for that agent (keyed by the connection name), shown in the agent editor. The agent must belong to your organization.
Body
application/jsontext/jsonapplication/*+json
MCP connection configuration
Model Context Protocol connection configuration for integrating external services with the agent. Defines how to connect to an MCP server including server URL, authentication, transport protocol, custom headers, and tool filtering.
Transport protocol for MCP communication. Supported values are SSE (Server-Sent Events for persistent connections) and StreamableHTTP (for request-response patterns).
List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.
List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).
Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).
Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).
Show child attributes
Response
Connection test completed successfully (check success field in response)
Results from testing a Model Context Protocol (MCP) server connection. Contains connection status, discovered tools, and performance metrics. Use this to verify MCP server connectivity and discover available capabilities before configuring agents.
Whether the connection test succeeded. When true, the MCP server was reachable, responded correctly, and tool discovery completed. When false, check the Message field for error details.
Tools discovered on the MCP server during the connection test. Each tool represents a capability that agents can use when this MCP connection is configured. Empty list when the connection failed or the server provides no tools.
Response time in milliseconds for the connection test. Indicates server responsiveness and network latency. Useful for evaluating performance before production use.
Human-readable message describing the test result. Contains error details when Success is false, or a confirmation message when the connection test succeeded.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dasha BlackBox Documentation","description":"Build, deploy, and monitor voice AI agents with Dasha BlackBox. Complete documentation for creating intelligent conversational AI agents with advanced voice capabilities.","colors":{"primary":"#4F46E5","light":"#6366F1","dark":"#312E81"},"logo":{"light":"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-light.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=d09a8bf9e3455eda1fccc003884b3cdf","dark":"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=1a3ce52b54cb5126d7f2cd2a42c27fa3","href":"https://blackbox.dasha.ai"},"favicon":"https://mintcdn.com/dasha-628f9d33/PM9rl5FBZe1J7dH8/docs/logo.svg?fit=max\u0026auto=format\u0026n=PM9rl5FBZe1J7dH8\u0026q=85\u0026s=21c9365f53a83564419467531fb20a5d","api":{"playground":{"display":"interactive"},"examples":{"languages":["javascript","curl","python"]}},"navbar":{"links":[{"href":"https://dasha.ai","label":"Explore other Dasha products"},{"href":"mailto:support+blackbox@dasha.ai","label":"Get Support"}],"primary":{"type":"button","label":"Go to Dashboard","href":"https://blackbox.dasha.ai"}},"footer":{"socials":{"x":"https://x.com/dashaai_","linkedin":"https://www.linkedin.com/company/dashaai","github":"https://github.com/dasha-ai"},"links":[{"header":"Resources","items":[{"label":"Main Website","href":"https://dasha.ai"},{"label":"Dashboard","href":"https://blackbox.dasha.ai"},{"label":"Status","href":"https://status.dasha.ai"}]},{"header":"Support","items":[{"label":"Get Support","href":"mailto:support+blackbox@dasha.ai"}]}]},"search":{"prompt":"Search Dasha BlackBox docs..."},"seo":{"metatags":{"canonical":"https://blackbox.dasha.ai"},"indexing":"navigable"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"integrations":{"posthog":{"apiKey":"phc_bF01JhDcDBEhCGS2wY8QMkGqrzgBQ25KxhcziHgwDvm","apiHost":"https://us.i.posthog.com"}},"errors":{"404":{"redirect":false,"title":"Page Not Found","description":"This page doesn't exist. Try using the search or navigation to find what you're looking for."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"chart-line","href":"https://status.dasha.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dasha-628f9d33","hasAudioNarration":false,"actualSubdomain":"dasha-628f9d33","customDomains":["docs.blackbox.dasha.ai"],"gitSource":{"type":"github","owner":"dasha-ai","repo":"blackbox-docs","deployBranch":"production","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeafa53b434e7d02a3a2567","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":119},{"language":"default","tag":"Documentation","count":64},{"language":"default","tag":"Create","count":19},{"language":"default","tag":"Advanced Features","count":18},{"language":"default","tag":"Deploy","count":11},{"language":"default","tag":"Introduction","count":9},{"language":"default","tag":"Calls","count":9},{"language":"default","tag":"Misc","count":9},{"language":"default","tag":"WebIntegrations","count":9},{"language":"default","tag":"Document","count":8}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@dasha.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/api-reference/mcp/verify-mcp-connection","slug":"/docs/api-reference/mcp/verify-mcp-connection","pageMetadata":{"title":"Verify MCP connection","description":"Verifies a Model Context Protocol (MCP) connection and discovers available tools.\nUse this endpoint to test MCP server connectivity before configuring an agent.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/mcp/verify","href":"/docs/api-reference/mcp/verify-mcp-connection","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Verifies a Model Context Protocol (MCP) connection and discovers available tools.\\nUse this endpoint to test MCP server connectivity before configuring an agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,ol:`ol`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`model-context-protocol-mcp`,children:`Model Context Protocol (MCP)`}),`\n`,_jsx(_components.p,{children:`MCP enables agents to connect to external services and data sources through a standardized protocol.\nVerify connections before configuring them on agents to ensure proper connectivity and tool discovery.`}),`\n`,_jsx(Heading,{level:`2`,id:`verification-process`,children:`Verification Process`}),`\n`,_jsx(_components.p,{children:`The verification:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Tests connectivity to the MCP server`}),`\n`,_jsx(_components.li,{children:`Discovers available tools and resources`}),`\n`,_jsx(_components.li,{children:`Returns connection status and available capabilities`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Test MCP server configuration before adding to an agent`}),`\n`,_jsx(_components.li,{children:`Discover what tools an MCP server provides`}),`\n`,_jsx(_components.li,{children:`Troubleshoot MCP connection issues`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Verify MCP connection","description":"Verifies a Model Context Protocol (MCP) connection and discovers available tools.\nUse this endpoint to test MCP server connectivity before configuring an agent.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/mcp/verify","href":"/docs/api-reference/mcp/verify-mcp-connection","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Model Context Protocol (MCP)","slug":"model-context-protocol-mcp","depth":2,"children":[]},{"title":"Verification Process","slug":"verification-process","depth":2,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Mcp"],"summary":"Verify MCP connection","description":"Verifies a Model Context Protocol (MCP) connection and discovers available tools.\nUse this endpoint to test MCP server connectivity before configuring an agent.","parameters":["9086ffce-a72d-4403-ad2c-85e098ae8242"],"requestBody":"90aac078-ecb1-42a3-a388-d55289270e01","responses":{"200":"1bb3ba33-77a7-46f1-b90a-5ece7eb670cb","400":"a378148c-3f4c-42e0-8b7b-19c2d5aaf5da","401":"7f29df6c-8e5e-4783-b67f-d4dc1f6bc03d","403":"64214320-a29a-4947-88ef-69d677f047d8","404":"ee4747d1-7c41-4aab-b7cb-7e0681c033ab","500":"f2cf7f6b-7081-4fcf-8de1-e716765d9662"},"x-mint":{"content":"## Model Context Protocol (MCP)\n\nMCP enables agents to connect to external services and data sources through a standardized protocol.\nVerify connections before configuring them on agents to ensure proper connectivity and tool discovery.\n\n## Verification Process\n\nThe verification:\n1. Tests connectivity to the MCP server\n2. Discovers available tools and resources\n3. Returns connection status and available capabilities\n\n## Use Cases\n\n- Test MCP server configuration before adding to an agent\n- Discover what tools an MCP server provides\n- Troubleshoot MCP connection issues"},"method":"post","type":"path","servers":["5fb0835c-a4f0-4503-aebe-00595f89e21f"],"security":["438e7f68-a155-42fd-8675-9d1199ae2693","bcfc7084-0b9a-4851-80ea-de419eddc013"],"path":"/api/v1/mcp/verify","baseUrlOptions":["https://blackbox.dasha.ai"],"title":"Verify MCP connection","codeSamples":[],"requestExampleLanguages":["javascript","bash","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9086ffce-a72d-4403-ad2c-85e098ae8242":{"name":"agentId","in":"query","description":"Optional agent the connection belongs to. When set, the outcome is saved as the connection's latest test result for that agent (keyed by the connection name), shown in the agent editor. The agent must belong to your organization.","schema":{"type":"string","description":"Optional agent the connection belongs to. When set, the outcome is saved as the connection's latest test result for that agent (keyed by the connection name), shown in the agent editor. The agent must belong to your organization.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"MCP connection configuration","content":{"application/json":{"schema":{"type":"object","description":"Model Context Protocol connection configuration for integrating external services with the agent. Defines how to connect to an MCP server including server URL, authentication, transport protocol, custom headers, and tool filtering.","required":["name","serverUrl"],"properties":{"name":{"minLength":1,"type":"string","description":"Display name for this MCP connection. Used to identify the connection in logs and configuration.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"serverUrl":{"type":"string","description":"MCP server URL to connect to. The URL format depends on the transport protocol (SSE uses HTTP/HTTPS endpoints, StreamableHTTP uses HTTP endpoints).","format":"uri","isRequired":true,"uniqueKey":"serverUrl","typeLabel":"string\u003curi>"},"authentication":{"oneOf":[{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["apiKey","type"],"properties":{"apiKey":{"minLength":1,"type":"string","description":"API key value to send with requests. This is the secret key provided by the MCP server.","isRequired":true,"uniqueKey":"authentication.oneOf.0.apiKey","typeLabel":"string"},"headerName":{"oneOf":[{"type":"string","description":"HTTP header name for the API key. Defaults to \"Authorization\" (the key is sent as the raw value, without a \"Bearer\" prefix). Set a custom header name such as \"X-API-Key\" if the MCP server expects one.","uniqueKey":"authentication.oneOf.0.headerName.oneOf.0","typeLabel":"string"},{"type":"null","description":"HTTP header name for the API key. Defaults to \"Authorization\" (the key is sent as the raw value, without a \"Bearer\" prefix). Set a custom header name such as \"X-API-Key\" if the MCP server expects one.","uniqueKey":"authentication.oneOf.0.headerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.oneOf.0.headerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"authentication.oneOf.0","typeLabel":"object"},{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["token","type"],"properties":{"token":{"minLength":1,"type":"string","description":"Bearer token value without the \"Bearer \" prefix. The system automatically adds the prefix when sending requests. This is the OAuth or JWT token provided by the MCP server or authorization service.","isRequired":true,"uniqueKey":"authentication.oneOf.1.token","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"authentication.oneOf.1","typeLabel":"object"},{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["type"],"properties":{},"additionalProperties":false,"uniqueKey":"authentication.oneOf.2","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.oneOf.3","typeLabel":"null"}],"uniqueKey":"authentication","typeLabel":"object · object · object · null"},"customHeaders":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"customHeaders.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include with each request to the MCP server. Useful for passing additional metadata or configuration to the server.","uniqueKey":"customHeaders.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"customHeaders.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include with each request to the MCP server. Useful for passing additional metadata or configuration to the server.","uniqueKey":"customHeaders.oneOf.1","typeLabel":"null"}],"uniqueKey":"customHeaders","typeLabel":"object | null"},"isEnabled":{"oneOf":[{"type":"boolean","description":"Whether this MCP connection is enabled. When disabled, the agent will not connect to this MCP server or use its tools.","default":true,"uniqueKey":"isEnabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this MCP connection is enabled. When disabled, the agent will not connect to this MCP server or use its tools.","default":true,"uniqueKey":"isEnabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"isEnabled","typeLabel":"boolean | null"},"description":{"oneOf":[{"type":"string","description":"Optional description explaining the purpose of this MCP connection or what services it provides.","default":null,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description explaining the purpose of this MCP connection or what services it provides.","default":null,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"transport":{"oneOf":[{"type":"string","description":"Transport protocol for MCP communication. Supported values are SSE (Server-Sent Events for persistent connections) and StreamableHTTP (for request-response patterns).","default":"SSE","enum":["SSE","StreamableHTTP"],"uniqueKey":"transport.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"transport","typeLabel":"enum\u003cstring> | null"},"blackListTools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"blackListTools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.","default":null,"uniqueKey":"blackListTools.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.","default":null,"uniqueKey":"blackListTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"blackListTools","typeLabel":"string[] | null"},"whiteListTools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"whiteListTools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).","default":null,"uniqueKey":"whiteListTools.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).","default":null,"uniqueKey":"whiteListTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"whiteListTools","typeLabel":"string[] | null"},"isLongRunning":{"oneOf":[{"type":"boolean","description":"Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":false,"uniqueKey":"isLongRunning.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":false,"uniqueKey":"isLongRunning.oneOf.1","typeLabel":"null"}],"uniqueKey":"isLongRunning","typeLabel":"boolean | null"},"longRunningTools":{"oneOf":[{"type":"array","items":{"required":["name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Raw MCP tool name, as reported by the MCP server and without the connection prefix.","isRequired":true,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].name","typeLabel":"string"},"additionalInstructions":{"oneOf":[{"type":"string","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions","typeLabel":"string | null"}},"additionalProperties":false,"description":"Marks a single tool of an MCP connection as slow. A slow tool never blocks the conversation: the agent gets an immediate acknowledgement, keeps talking to the user, and the real result is added to the conversation history once the MCP server answers.","uniqueKey":"longRunningTools.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":null,"uniqueKey":"longRunningTools.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"required":["name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Raw MCP tool name, as reported by the MCP server and without the connection prefix."},"additionalInstructions":{"oneOf":[{"type":"string","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null},{"type":"null","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null}]}},"additionalProperties":false,"description":"Marks a single tool of an MCP connection as slow. A slow tool never blocks the conversation: the agent gets an immediate acknowledgement, keeps talking to the user, and the real result is added to the conversation history once the MCP server answers."},"description":"Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":null,"uniqueKey":"longRunningTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"longRunningTools","typeLabel":"object[] | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","serverUrl":"\u003cstring>","authentication":{"apiKey":"\u003cstring>","headerName":"\u003cstring>"},"customHeaders":{},"isEnabled":true,"description":null,"transport":"SSE","blackListTools":null,"whiteListTools":null,"isLongRunning":false,"longRunningTools":null}}},"exampleType":"generated"},"text/json":{"schema":{"type":"object","description":"Model Context Protocol connection configuration for integrating external services with the agent. Defines how to connect to an MCP server including server URL, authentication, transport protocol, custom headers, and tool filtering.","required":["name","serverUrl"],"properties":{"name":{"minLength":1,"type":"string","description":"Display name for this MCP connection. Used to identify the connection in logs and configuration.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"serverUrl":{"type":"string","description":"MCP server URL to connect to. The URL format depends on the transport protocol (SSE uses HTTP/HTTPS endpoints, StreamableHTTP uses HTTP endpoints).","format":"uri","isRequired":true,"uniqueKey":"serverUrl","typeLabel":"string\u003curi>"},"authentication":{"oneOf":[{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["apiKey","type"],"properties":{"apiKey":{"minLength":1,"type":"string","description":"API key value to send with requests. This is the secret key provided by the MCP server.","isRequired":true,"uniqueKey":"authentication.oneOf.0.apiKey","typeLabel":"string"},"headerName":{"oneOf":[{"type":"string","description":"HTTP header name for the API key. Defaults to \"Authorization\" (the key is sent as the raw value, without a \"Bearer\" prefix). Set a custom header name such as \"X-API-Key\" if the MCP server expects one.","uniqueKey":"authentication.oneOf.0.headerName.oneOf.0","typeLabel":"string"},{"type":"null","description":"HTTP header name for the API key. Defaults to \"Authorization\" (the key is sent as the raw value, without a \"Bearer\" prefix). Set a custom header name such as \"X-API-Key\" if the MCP server expects one.","uniqueKey":"authentication.oneOf.0.headerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.oneOf.0.headerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"authentication.oneOf.0","typeLabel":"object"},{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["token","type"],"properties":{"token":{"minLength":1,"type":"string","description":"Bearer token value without the \"Bearer \" prefix. The system automatically adds the prefix when sending requests. This is the OAuth or JWT token provided by the MCP server or authorization service.","isRequired":true,"uniqueKey":"authentication.oneOf.1.token","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"authentication.oneOf.1","typeLabel":"object"},{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["type"],"properties":{},"additionalProperties":false,"uniqueKey":"authentication.oneOf.2","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.oneOf.3","typeLabel":"null"}],"uniqueKey":"authentication","typeLabel":"object · object · object · null"},"customHeaders":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"customHeaders.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include with each request to the MCP server. Useful for passing additional metadata or configuration to the server.","uniqueKey":"customHeaders.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"customHeaders.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include with each request to the MCP server. Useful for passing additional metadata or configuration to the server.","uniqueKey":"customHeaders.oneOf.1","typeLabel":"null"}],"uniqueKey":"customHeaders","typeLabel":"object | null"},"isEnabled":{"oneOf":[{"type":"boolean","description":"Whether this MCP connection is enabled. When disabled, the agent will not connect to this MCP server or use its tools.","default":true,"uniqueKey":"isEnabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this MCP connection is enabled. When disabled, the agent will not connect to this MCP server or use its tools.","default":true,"uniqueKey":"isEnabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"isEnabled","typeLabel":"boolean | null"},"description":{"oneOf":[{"type":"string","description":"Optional description explaining the purpose of this MCP connection or what services it provides.","default":null,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description explaining the purpose of this MCP connection or what services it provides.","default":null,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"transport":{"oneOf":[{"type":"string","description":"Transport protocol for MCP communication. Supported values are SSE (Server-Sent Events for persistent connections) and StreamableHTTP (for request-response patterns).","default":"SSE","enum":["SSE","StreamableHTTP"],"uniqueKey":"transport.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"transport","typeLabel":"enum\u003cstring> | null"},"blackListTools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"blackListTools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.","default":null,"uniqueKey":"blackListTools.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.","default":null,"uniqueKey":"blackListTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"blackListTools","typeLabel":"string[] | null"},"whiteListTools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"whiteListTools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).","default":null,"uniqueKey":"whiteListTools.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).","default":null,"uniqueKey":"whiteListTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"whiteListTools","typeLabel":"string[] | null"},"isLongRunning":{"oneOf":[{"type":"boolean","description":"Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":false,"uniqueKey":"isLongRunning.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":false,"uniqueKey":"isLongRunning.oneOf.1","typeLabel":"null"}],"uniqueKey":"isLongRunning","typeLabel":"boolean | null"},"longRunningTools":{"oneOf":[{"type":"array","items":{"required":["name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Raw MCP tool name, as reported by the MCP server and without the connection prefix.","isRequired":true,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].name","typeLabel":"string"},"additionalInstructions":{"oneOf":[{"type":"string","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions","typeLabel":"string | null"}},"additionalProperties":false,"description":"Marks a single tool of an MCP connection as slow. A slow tool never blocks the conversation: the agent gets an immediate acknowledgement, keeps talking to the user, and the real result is added to the conversation history once the MCP server answers.","uniqueKey":"longRunningTools.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":null,"uniqueKey":"longRunningTools.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"required":["name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Raw MCP tool name, as reported by the MCP server and without the connection prefix."},"additionalInstructions":{"oneOf":[{"type":"string","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null},{"type":"null","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null}]}},"additionalProperties":false,"description":"Marks a single tool of an MCP connection as slow. A slow tool never blocks the conversation: the agent gets an immediate acknowledgement, keeps talking to the user, and the real result is added to the conversation history once the MCP server answers."},"description":"Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":null,"uniqueKey":"longRunningTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"longRunningTools","typeLabel":"object[] | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","serverUrl":"\u003cstring>","authentication":{"apiKey":"\u003cstring>","headerName":"\u003cstring>"},"customHeaders":{},"isEnabled":true,"description":null,"transport":"SSE","blackListTools":null,"whiteListTools":null,"isLongRunning":false,"longRunningTools":null}}},"exampleType":"generated"},"application/*+json":{"schema":{"type":"object","description":"Model Context Protocol connection configuration for integrating external services with the agent. Defines how to connect to an MCP server including server URL, authentication, transport protocol, custom headers, and tool filtering.","required":["name","serverUrl"],"properties":{"name":{"minLength":1,"type":"string","description":"Display name for this MCP connection. Used to identify the connection in logs and configuration.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"serverUrl":{"type":"string","description":"MCP server URL to connect to. The URL format depends on the transport protocol (SSE uses HTTP/HTTPS endpoints, StreamableHTTP uses HTTP endpoints).","format":"uri","isRequired":true,"uniqueKey":"serverUrl","typeLabel":"string\u003curi>"},"authentication":{"oneOf":[{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["apiKey","type"],"properties":{"apiKey":{"minLength":1,"type":"string","description":"API key value to send with requests. This is the secret key provided by the MCP server.","isRequired":true,"uniqueKey":"authentication.oneOf.0.apiKey","typeLabel":"string"},"headerName":{"oneOf":[{"type":"string","description":"HTTP header name for the API key. Defaults to \"Authorization\" (the key is sent as the raw value, without a \"Bearer\" prefix). Set a custom header name such as \"X-API-Key\" if the MCP server expects one.","uniqueKey":"authentication.oneOf.0.headerName.oneOf.0","typeLabel":"string"},{"type":"null","description":"HTTP header name for the API key. Defaults to \"Authorization\" (the key is sent as the raw value, without a \"Bearer\" prefix). Set a custom header name such as \"X-API-Key\" if the MCP server expects one.","uniqueKey":"authentication.oneOf.0.headerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.oneOf.0.headerName","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"authentication.oneOf.0","typeLabel":"object"},{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["token","type"],"properties":{"token":{"minLength":1,"type":"string","description":"Bearer token value without the \"Bearer \" prefix. The system automatically adds the prefix when sending requests. This is the OAuth or JWT token provided by the MCP server or authorization service.","isRequired":true,"uniqueKey":"authentication.oneOf.1.token","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"authentication.oneOf.1","typeLabel":"object"},{"type":"object","description":"Authentication configuration for the MCP server. Supported types include none, API key, bearer token, and custom authentication schemes.","required":["type"],"properties":{},"additionalProperties":false,"uniqueKey":"authentication.oneOf.2","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.oneOf.3","typeLabel":"null"}],"uniqueKey":"authentication","typeLabel":"object · object · object · null"},"customHeaders":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"customHeaders.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include with each request to the MCP server. Useful for passing additional metadata or configuration to the server.","uniqueKey":"customHeaders.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"customHeaders.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Custom HTTP headers to include with each request to the MCP server. Useful for passing additional metadata or configuration to the server.","uniqueKey":"customHeaders.oneOf.1","typeLabel":"null"}],"uniqueKey":"customHeaders","typeLabel":"object | null"},"isEnabled":{"oneOf":[{"type":"boolean","description":"Whether this MCP connection is enabled. When disabled, the agent will not connect to this MCP server or use its tools.","default":true,"uniqueKey":"isEnabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this MCP connection is enabled. When disabled, the agent will not connect to this MCP server or use its tools.","default":true,"uniqueKey":"isEnabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"isEnabled","typeLabel":"boolean | null"},"description":{"oneOf":[{"type":"string","description":"Optional description explaining the purpose of this MCP connection or what services it provides.","default":null,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description explaining the purpose of this MCP connection or what services it provides.","default":null,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"transport":{"oneOf":[{"type":"string","description":"Transport protocol for MCP communication. Supported values are SSE (Server-Sent Events for persistent connections) and StreamableHTTP (for request-response patterns).","default":"SSE","enum":["SSE","StreamableHTTP"],"uniqueKey":"transport.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"transport","typeLabel":"enum\u003cstring> | null"},"blackListTools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"blackListTools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.","default":null,"uniqueKey":"blackListTools.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"List of tool names to exclude from this MCP connection. Tools in this list will not be available to the agent even if the MCP server provides them. Useful for restricting access to specific tools.","default":null,"uniqueKey":"blackListTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"blackListTools","typeLabel":"string[] | null"},"whiteListTools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"whiteListTools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).","default":null,"uniqueKey":"whiteListTools.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"List of tool names to allow from this MCP connection. When specified, only tools in this list will be available to the agent. If not specified, all tools from the server are available (subject to BlackListTools).","default":null,"uniqueKey":"whiteListTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"whiteListTools","typeLabel":"string[] | null"},"isLongRunning":{"oneOf":[{"type":"boolean","description":"Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":false,"uniqueKey":"isLongRunning.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether every tool from this MCP connection is potentially slow. A slow tool call does not block the conversation: the agent receives an immediate acknowledgement, keeps talking to the user, and the real result is injected into the conversation history once the MCP server answers. Use LongRunningTools instead to mark only some of the connection's tools. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":false,"uniqueKey":"isLongRunning.oneOf.1","typeLabel":"null"}],"uniqueKey":"isLongRunning","typeLabel":"boolean | null"},"longRunningTools":{"oneOf":[{"type":"array","items":{"required":["name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Raw MCP tool name, as reported by the MCP server and without the connection prefix.","isRequired":true,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].name","typeLabel":"string"},"additionalInstructions":{"oneOf":[{"type":"string","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null,"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"longRunningTools.oneOf.0.items.[INDEX].additionalInstructions","typeLabel":"string | null"}},"additionalProperties":false,"description":"Marks a single tool of an MCP connection as slow. A slow tool never blocks the conversation: the agent gets an immediate acknowledgement, keeps talking to the user, and the real result is added to the conversation history once the MCP server answers.","uniqueKey":"longRunningTools.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":null,"uniqueKey":"longRunningTools.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"required":["name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Raw MCP tool name, as reported by the MCP server and without the connection prefix."},"additionalInstructions":{"oneOf":[{"type":"string","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null},{"type":"null","description":"Extra guidance for the agent about this specific slow tool, delivered to it together with the acknowledgement the moment the tool is called. Use it to tell the agent what to say while the result is pending, for example how long the lookup usually takes.","default":null}]}},"additionalProperties":false,"description":"Marks a single tool of an MCP connection as slow. A slow tool never blocks the conversation: the agent gets an immediate acknowledgement, keeps talking to the user, and the real result is added to the conversation history once the MCP server answers."},"description":"Individual tools of this connection that are slow, each with optional extra guidance for the agent. Tools listed here are slow even when IsLongRunning is disabled; when IsLongRunning is enabled every tool of the connection is slow and this list only supplies the per-tool guidance. Not used when enhanced tooling is enabled in the LLM configuration (LlmConfig.EnhancedTooling).","default":null,"uniqueKey":"longRunningTools.oneOf.1","typeLabel":"null"}],"uniqueKey":"longRunningTools","typeLabel":"object[] | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","serverUrl":"\u003cstring>","authentication":{"apiKey":"\u003cstring>","headerName":"\u003cstring>"},"customHeaders":{},"isEnabled":true,"description":null,"transport":"SSE","blackListTools":null,"whiteListTools":null,"isLongRunning":false,"longRunningTools":null}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1bb3ba33-77a7-46f1-b90a-5ece7eb670cb":{"description":"Connection test completed successfully (check success field in response)","content":{"application/json":{"schema":{"required":["availableTools","responseTimeMs","success","testedAt"],"type":"object","properties":{"success":{"type":"boolean","description":"Whether the connection test succeeded. When true, the MCP server was reachable, responded correctly, and tool discovery completed. When false, check the Message field for error details.","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"availableTools":{"type":"array","items":{"required":["description","isEnabled","name","schema"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Unique name of the tool as defined by the MCP server. Used to identify and invoke the tool when agents need to use this capability during conversations.","isRequired":true,"uniqueKey":"availableTools.items.[INDEX].name","typeLabel":"string"},"description":{"minLength":1,"type":"string","description":"Human-readable description of what the tool does. Helps agents understand when and how to use this tool, and may be used by the LLM to decide whether to invoke the tool based on conversation context.","isRequired":true,"uniqueKey":"availableTools.items.[INDEX].description","typeLabel":"string"},"schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"availableTools.items.[INDEX].schema.additionalProperties","typeLabel":"any"},"description":"JSON Schema defining the tool's input parameters. Describes the structure, types, and validation rules for arguments that must be provided when invoking the tool. Used by agents to construct valid tool invocation requests.","isRequired":true,"uniqueKey":"availableTools.items.[INDEX].schema","typeLabel":"object"},"isEnabled":{"type":"boolean","description":"Whether this tool is enabled for use by agents. When false, the tool is discovered but not available for invocation, allowing selective tool access control without reconfiguring the MCP connection.","isRequired":true,"uniqueKey":"availableTools.items.[INDEX].isEnabled","typeLabel":"boolean"}},"additionalProperties":false,"description":"Tool discovered from a Model Context Protocol (MCP) server. Represents a capability that agents can invoke through the MCP connection, such as database queries, API calls, file operations, or custom business logic exposed by the MCP server.","uniqueKey":"availableTools.items.[INDEX]","typeLabel":"object"},"description":"Tools discovered on the MCP server during the connection test. Each tool represents a capability that agents can use when this MCP connection is configured. Empty list when the connection failed or the server provides no tools.","isRequired":true,"uniqueKey":"availableTools","typeLabel":"object[]"},"testedAt":{"type":"string","description":"Timestamp when the connection test was performed.","format":"date-time","isRequired":true,"uniqueKey":"testedAt","typeLabel":"string\u003cdate-time>"},"responseTimeMs":{"type":"number","description":"Response time in milliseconds for the connection test. Indicates server responsiveness and network latency. Useful for evaluating performance before production use.","format":"double","isRequired":true,"uniqueKey":"responseTimeMs","typeLabel":"number\u003cdouble>"},"message":{"oneOf":[{"type":"string","description":"Human-readable message describing the test result. Contains error details when Success is false, or a confirmation message when the connection test succeeded.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable message describing the test result. Contains error details when Success is false, or a confirmation message when the connection test succeeded.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"additionalProperties":false,"description":"Results from testing a Model Context Protocol (MCP) server connection. Contains connection status, discovered tools, and performance metrics. Use this to verify MCP server connectivity and discover available capabilities before configuring agents.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"availableTools":[{"name":"\u003cstring>","description":"\u003cstring>","schema":{},"isEnabled":true}],"testedAt":"2023-11-07T05:31:56Z","responseTimeMs":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a378148c-3f4c-42e0-8b7b-19c2d5aaf5da":{"description":"Invalid MCP connection configuration or validation errors","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7f29df6c-8e5e-4783-b67f-d4dc1f6bc03d":{"description":"Authentication failed or API key is missing","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"64214320-a29a-4947-88ef-69d677f047d8":{"description":"Organization not authorized for MCP connections","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ee4747d1-7c41-4aab-b7cb-7e0681c033ab":{"description":"The agent given in agentId does not exist in your organization","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f2cf7f6b-7081-4fcf-8de1-e716765d9662":{"description":"Server error occurred during connection test","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"438e7f68-a155-42fd-8675-9d1199ae2693":{"ApiKey":{"type":"http","description":"API Key Authentication (Bearer {key})","scheme":"Bearer","scopes":[],"schemeName":"ApiKey"}},"bcfc7084-0b9a-4851-80ea-de419eddc013":{"OAuth":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.dasha.ai/connect/authorize","scopes":{"platform_api":"Platform API"}}},"scopes":[],"schemeName":"OAuth"}}},"servers":{"5fb0835c-a4f0-4503-aebe-00595f89e21f":{"url":"https://blackbox.dasha.ai","description":"Dasha BlackBox Agent API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"API Key Authentication (Bearer {key})","scheme":"Bearer","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API Key Authentication (Bearer {key})","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.dasha.ai/connect/authorize","scopes":{"platform_api":"Platform API"}}},"scopes":[],"schemeName":"OAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth","name":"Authorization"}],"title":"OAuth"}]},"originalFileLocation":"https://blackbox.dasha.ai/swagger/v1/swagger.json"},"subdomain":"dasha-628f9d33","siteName":"Dasha BlackBox Documentation","title":"Verify MCP connection - Dasha BlackBox Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T09:27:34.673Z","originalFileLocation":"docs/api-reference/mcp/verify-mcp-connection.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Verifies a Model Context Protocol (MCP) connection and discovers available tools. Use this endpoint to test MCP server connectivity before configuring an agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Verify MCP connection - Dasha BlackBox Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Verifies a Model Context Protocol (MCP) connection and discovers available tools. Use this endpoint to test MCP server connectivity before configuring an agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dasha-628f9d33.mintlify.site/_mintlify/api/og/v2?division=Mcp\u0026amp;title=Verify+MCP+connection\u0026amp;description=Verifies+a+Model+Context+Protocol+%28MCP%29+connection+and+discovers+available+tools.%0AUse+this+endpoint+to+test+MCP+server+connectivity+before+configuring+an+agent.\u0026amp;theme=8f648b54f3a39a57bca8af12\u0026amp;signature=d6581812d213362839cf62d4825d10e6ae56903ca8ca29a9ad23c49476b92630\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Verify MCP connection - Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Verifies a Model Context Protocol (MCP) connection and discovers available tools. Use this endpoint to test MCP server connectivity before configuring an agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dasha-628f9d33.mintlify.site/_mintlify/api/og/v2?division=Mcp\u0026amp;title=Verify+MCP+connection\u0026amp;description=Verifies+a+Model+Context+Protocol+%28MCP%29+connection+and+discovers+available+tools.%0AUse+this+endpoint+to+test+MCP+server+connectivity+before+configuring+an+agent.\u0026amp;theme=8f648b54f3a39a57bca8af12\u0026amp;signature=d6581812d213362839cf62d4825d10e6ae56903ca8ca29a9ad23c49476b92630\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/mcp/verify-mcp-connection.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://blackbox.dasha.ai/#organization\",\"name\":\"Dasha BlackBox Documentation\",\"url\":\"https://blackbox.dasha.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-light.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=d09a8bf9e3455eda1fccc003884b3cdf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://blackbox.dasha.ai#website\",\"name\":\"Dasha BlackBox Documentation\",\"url\":\"https://blackbox.dasha.ai\",\"publisher\":{\"@id\":\"https://blackbox.dasha.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection#webpage\",\"url\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection\",\"name\":\"Verify MCP connection\",\"description\":\"Verifies a Model Context Protocol (MCP) connection and discovers available tools. Use this endpoint to test MCP server connectivity before configuring an agent.\",\"dateModified\":\"2026-11-04T09:27:34.673Z\",\"isPartOf\":{\"@id\":\"https://blackbox.dasha.ai#website\"},\"breadcrumb\":{\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dasha BlackBox Documentation\",\"item\":\"https://blackbox.dasha.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Verify MCP connection\",\"item\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection#apireference\",\"headline\":\"Verify MCP connection\",\"name\":\"Verify MCP connection\",\"description\":\"Verifies a Model Context Protocol (MCP) connection and discovers available tools. Use this endpoint to test MCP server connectivity before configuring an agent.\",\"url\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection\",\"mainEntityOfPage\":{\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection#webpage\"},\"dateModified\":\"2026-11-04T09:27:34.673Z\",\"publisher\":{\"@id\":\"https://blackbox.dasha.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://blackbox.dasha.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dasha BlackBox Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dasha BlackBox Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/mcp/verify-mcp-connection.md","siteName":"Dasha BlackBox Documentation","nav":{"global":{"anchors":[{"anchor":"Status","icon":"chart-line","href":"https://status.dasha.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction/what-is-blackbox"}]},{"tab":"API Reference","groups":[{"group":"ActivityLogs","pages":[{"title":"Search activity log","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/activity-logs/search","href":"/docs/api-reference/activitylogs/search-activity-log"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents","href":"/docs/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/agents","href":"/docs/api-reference/agents/create-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/delete-agent"},{"title":"Clone agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/agents/{agentId}/clone","href":"/docs/api-reference/agents/clone-agent"},{"title":"Get agents linked to knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/knowledge-base/list","href":"/docs/api-reference/agents/get-agents-linked-to-knowledge-base"}]},{"group":"AgentTestCases","pages":[]},{"group":"AgentToolTestResults","pages":[]},{"group":"CallResults","pages":[{"title":"Search call results","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/callresults/search","href":"/docs/api-reference/callresults/search-call-results"}]},{"group":"Calls","pages":[{"title":"Create call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls","href":"/docs/api-reference/calls/create-call"},{"title":"Register inbound call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/register","href":"/docs/api-reference/calls/register-inbound-call"},{"title":"Create bulk calls","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/bulk","href":"/docs/api-reference/calls/create-bulk-calls"},{"title":"Get call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}","href":"/docs/api-reference/calls/get-call"},{"title":"Cancel call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/calls/{callId}","href":"/docs/api-reference/calls/cancel-call"},{"title":"Get call queue","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/queue/list","href":"/docs/api-reference/calls/get-call-queue"},{"title":"Get call statistics","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/statistics/statuses","href":"/docs/api-reference/calls/get-call-statistics"},{"title":"Get call recording","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/media/{recordId}","href":"/docs/api-reference/calls/get-call-recording"},{"title":"Get SIP traces","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}/sip-traces","href":"/docs/api-reference/calls/get-sip-traces"}]},{"group":"Chats","pages":[{"title":"List chat sessions matching the supplied filters.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/chats","href":"/docs/api-reference/chats/list-chat-sessions-matching-the-supplied-filters"},{"title":"Open a new chat session.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats","href":"/docs/api-reference/chats/open-a-new-chat-session"},{"title":"Submit one user turn to an existing chat session.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats/{id}/messages","href":"/docs/api-reference/chats/submit-one-user-turn-to-an-existing-chat-session"},{"title":"Retrieve a chat session — full transcript and lifecycle status.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/chats/{id}","href":"/docs/api-reference/chats/retrieve-a-chat-session-—-full-transcript-and-lifecycle-status"},{"title":"End a chat session under the `user_end` reason.","description":"Runs the same lifecycle pipeline a voice call's completion does: post-call analysis,\ncompletion webhook, Postgres CallResult, Elasticsearch index, audit event. Idempotent —\ncalling on an already-final session returns the current snapshot without re-running the\npipeline.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats/{id}/end","href":"/docs/api-reference/chats/end-a-chat-session-under-the-`user_end`-reason"}]},{"group":"Copilot","pages":[]},{"group":"CustomerData","pages":[]},{"group":"Mcp","pages":[{"title":"Verify MCP connection","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/mcp/verify","href":"/docs/api-reference/mcp/verify-mcp-connection"}]},{"group":"Media","pages":[{"title":"List media files","description":"Retrieves all media files for your organization with pagination support.\nReturns metadata including file names, descriptions, upload dates, and file sizes.\nSet fileName to look up the file that an agent configuration references by its stored file name.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media","href":"/docs/api-reference/media/list-media-files"},{"title":"Upload media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/media","href":"/docs/api-reference/media/upload-media-file"},{"title":"Get media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}","href":"/docs/api-reference/media/get-media-file"},{"title":"Delete media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/media/{id}","href":"/docs/api-reference/media/delete-media-file"},{"title":"Update media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/media/{id}","href":"/docs/api-reference/media/update-media-file"},{"title":"Download media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/download","href":"/docs/api-reference/media/download-media-file"},{"title":"Get agents using media","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/affected-agents","href":"/docs/api-reference/media/get-agents-using-media"}]},{"group":"Misc","pages":[{"title":"Get server configuration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc","href":"/docs/api-reference/misc/get-server-configuration"},{"title":"Get current organization","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/me","href":"/docs/api-reference/misc/get-current-organization"},{"title":"Get concurrency limits","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/concurrency","href":"/docs/api-reference/misc/get-concurrency-limits"},{"title":"Get agent template","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/agent-initial-data","href":"/docs/api-reference/misc/get-agent-template"},{"title":"List predefined background sounds","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/background-sounds","href":"/docs/api-reference/misc/list-predefined-background-sounds"},{"title":"List predefined builtin media","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-media","href":"/docs/api-reference/misc/list-predefined-builtin-media"},{"title":"List predefined built-in tools","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-tools","href":"/docs/api-reference/misc/list-predefined-built-in-tools"},{"title":"Get platform capabilities","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/capabilities","href":"/docs/api-reference/misc/get-platform-capabilities"},{"title":"Get capabilities of available models","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/misc/capabilities","href":"/docs/api-reference/misc/get-capabilities-of-available-models"}]},{"group":"OpsDashboard","pages":[]},{"group":"PronunciationDictionaries","pages":[{"title":"List pronunciation dictionaries","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries","href":"/docs/api-reference/pronunciationdictionaries/list-pronunciation-dictionaries"},{"title":"Create pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries","href":"/docs/api-reference/pronunciationdictionaries/create-pronunciation-dictionary"},{"title":"Get pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries/{providerId}","href":"/docs/api-reference/pronunciationdictionaries/get-pronunciation-dictionary"},{"title":"Delete pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/pronunciation-dictionaries/{providerId}","href":"/docs/api-reference/pronunciationdictionaries/delete-pronunciation-dictionary"},{"title":"Add pronunciation rules","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries/{providerId}/add-rules","href":"/docs/api-reference/pronunciationdictionaries/add-pronunciation-rules"},{"title":"Remove pronunciation rules","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries/{providerId}/remove-rules","href":"/docs/api-reference/pronunciationdictionaries/remove-pronunciation-rules"},{"title":"Get agents using pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries/{providerId}/affected-agents","href":"/docs/api-reference/pronunciationdictionaries/get-agents-using-pronunciation-dictionary"}]},{"group":"Providers","pages":[{"title":"List providers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers","href":"/docs/api-reference/providers/list-providers"},{"title":"Get provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/{id}","href":"/docs/api-reference/providers/get-provider"},{"title":"Delete provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/providers/{id}","href":"/docs/api-reference/providers/delete-provider"},{"title":"Verify provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/{id}/verify","href":"/docs/api-reference/providers/verify-provider"}]},{"group":"SipAliases","pages":[]},{"group":"SipCredentials","pages":[{"title":"List SIP credentials","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials","href":"/docs/api-reference/sipcredentials/list-sip-credentials"},{"title":"Create SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-credentials","href":"/docs/api-reference/sipcredentials/create-sip-credential"},{"title":"Get SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/get-sip-credential"},{"title":"Update SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/update-sip-credential"},{"title":"Delete SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/delete-sip-credential"},{"title":"Get agents using SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}/affected-agents","href":"/docs/api-reference/sipcredentials/get-agents-using-sip-credential"}]},{"group":"SipDomains","pages":[{"title":"List custom SIP domains","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-domains","href":"/docs/api-reference/sipdomains/list-custom-sip-domains"},{"title":"Add custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-domains","href":"/docs/api-reference/sipdomains/add-custom-sip-domain"},{"title":"Get custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/get-custom-sip-domain"},{"title":"Delete custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/delete-custom-sip-domain"},{"title":"Update inbound routing of a custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/update-inbound-routing-of-a-custom-sip-domain"},{"title":"Verify custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-domains/{id}/verify","href":"/docs/api-reference/sipdomains/verify-custom-sip-domain"}]},{"group":"SipPhoneNumbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers","href":"/docs/api-reference/sipphonenumbers/list-phone-numbers"},{"title":"Create phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-phone-numbers","href":"/docs/api-reference/sipphonenumbers/create-phone-number"},{"title":"Get phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/get-phone-number"},{"title":"Update phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/update-phone-number"},{"title":"Delete phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/delete-phone-number"},{"title":"Link phone number to agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-phone-numbers/{id}/agent-link","href":"/docs/api-reference/sipphonenumbers/link-phone-number-to-agent"},{"title":"Unlink phone number from agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-phone-numbers/{id}/agent-link","href":"/docs/api-reference/sipphonenumbers/unlink-phone-number-from-agent"},{"title":"Get agents using phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers/{id}/affected-agents","href":"/docs/api-reference/sipphonenumbers/get-agents-using-phone-number"}]},{"group":"SipRegisterCallWebhook","pages":[]},{"group":"TextChat","pages":[{"title":"Run one stateless text-chat completion turn.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/text-chat/completion","href":"/docs/api-reference/textchat/run-one-stateless-text-chat-completion-turn"}]},{"group":"TwilioProvider","pages":[{"title":"Get Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/twilio/{id}","href":"/docs/api-reference/twilioprovider/get-twilio-provider"},{"title":"Update Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/providers/twilio/{id}","href":"/docs/api-reference/twilioprovider/update-twilio-provider"},{"title":"Create Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/twilio","href":"/docs/api-reference/twilioprovider/create-twilio-provider"},{"title":"Update Auth Token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/providers/twilio/{id}/auth-token","href":"/docs/api-reference/twilioprovider/update-auth-token"},{"title":"List available phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/twilio/{id}/available-numbers","href":"/docs/api-reference/twilioprovider/list-available-phone-numbers"},{"title":"Import phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/twilio/{id}/import-numbers","href":"/docs/api-reference/twilioprovider/import-phone-numbers"},{"title":"Remove phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/providers/twilio/{id}/phone-numbers/{phoneNumberId}","href":"/docs/api-reference/twilioprovider/remove-phone-number"}]},{"group":"Voice","pages":[{"title":"List available voices","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice","href":"/docs/api-reference/voice/list-available-voices"},{"title":"Synthesize text to speech","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/voice/synthesize","href":"/docs/api-reference/voice/synthesize-text-to-speech"},{"title":"Get built-in sound audio","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice/builtin-media","href":"/docs/api-reference/voice/get-built-in-sound-audio"},{"title":"Clone voice from audio","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/voice/clone","href":"/docs/api-reference/voice/clone-voice-from-audio"},{"title":"Delete cloned voice","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/voice/clone/{voiceId}","href":"/docs/api-reference/voice/delete-cloned-voice"},{"title":"Update cloned voice","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/voice/clone/{voiceId}","href":"/docs/api-reference/voice/update-cloned-voice"}]},{"group":"WebhookTest","pages":[{"title":"Test webhook endpoint","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/webhooks/test","href":"/docs/api-reference/webhooktest/test-webhook-endpoint"}]},{"group":"WebIntegrations","pages":[{"title":"List web integrations","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/list-web-integrations"},{"title":"Update web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/update-web-integration"},{"title":"Create web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/create-web-integration"},{"title":"Get web integrations by agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/agent","href":"/docs/api-reference/webintegrations/get-web-integrations-by-agent"},{"title":"Get web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/integration","href":"/docs/api-reference/webintegrations/get-web-integration"},{"title":"Delete web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/web-integrations/{integrationId}","href":"/docs/api-reference/webintegrations/delete-web-integration"},{"title":"Create integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/web-integrations/{integrationId}/tokens","href":"/docs/api-reference/webintegrations/create-integration-token"},{"title":"Delete integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/web-integrations/{integrationId}/tokens/{tokenId}","href":"/docs/api-reference/webintegrations/delete-integration-token"},{"title":"Validate integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/discover","href":"/docs/api-reference/webintegrations/validate-integration-token"}]},{"group":"WebSocket","pages":[{"title":"WebSocket endpoint for web calls","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/ws/webCall","href":"/docs/api-reference/websocket/websocket-endpoint-for-web-calls"},{"title":"Get WebSocket endpoint information","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/ws/info","href":"/docs/api-reference/websocket/get-websocket-endpoint-information"}]},{"group":"Document","pages":[{"title":"List documents in a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document","href":"/docs/api-reference/document/list-documents-in-a-knowledge-base"},{"title":"Upload a document to a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/document","href":"/docs/api-reference/document/upload-a-document-to-a-knowledge-base"},{"title":"Get document details with status","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}","href":"/docs/api-reference/document/get-document-details-with-status"},{"title":"Update a document content in KB","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/document/{id}","href":"/docs/api-reference/document/update-a-document-content-in-kb"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/document/{id}","href":"/docs/api-reference/document/delete-a-document"},{"title":"Get document chunks","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}/chunks","href":"/docs/api-reference/document/get-document-chunks"},{"title":"Get document chunk information","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/chunks/{chunkId}","href":"/docs/api-reference/document/get-document-chunk-information"},{"title":"Download document content","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}/download","href":"/docs/api-reference/document/download-document-content"}]},{"group":"KnowledgeBase","pages":[{"title":"Get all knowledge","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb","href":"/docs/api-reference/knowledgebase/get-all-knowledge"},{"title":"Create a new knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb","href":"/docs/api-reference/knowledgebase/create-a-new-knowledge-base"},{"title":"Get knowledge base details with statistics","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/get-knowledge-base-details-with-statistics"},{"title":"Update knowledge base settings","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/update-knowledge-base-settings"},{"title":"Delete a knowledge base and all its content","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/delete-a-knowledge-base-and-all-its-content"}]},{"group":"KnowledgeBaseSource","pages":[{"title":"List the URL sources of a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/list-the-url-sources-of-a-knowledge-base"},{"title":"Add a URL source to a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base"},{"title":"Get a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/get-a-url-source"},{"title":"Update the settings of a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/update-the-settings-of-a-url-source"},{"title":"Remove a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/remove-a-url-source"},{"title":"Crawl a URL source now","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources/{sourceId}/crawl","href":"/docs/api-reference/knowledgebasesource/crawl-a-url-source-now"},{"title":"List the pages of a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}/pages","href":"/docs/api-reference/knowledgebasesource/list-the-pages-of-a-url-source"},{"title":"Get the page usage of all URL sources","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/sources/usage","href":"/docs/api-reference/knowledgebasesource/get-the-page-usage-of-all-url-sources"}]},{"group":"Search","pages":[{"title":"Search within a multi knowledge bases","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/search","href":"/docs/api-reference/search/search-within-a-multi-knowledge-bases"}]}]}]},"basePath":"","title":"Verify MCP connection - Dasha BlackBox Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}