Activate and deactivate skill-embedded MCP (Model Context Protocol) servers
MCP skills API
Manage skill-embedded MCP servers that provide additional tools to agents. Each skill can bundle its own MCP server with a set of tools. Activate a skill’s MCP server on demand and deactivate it when no longer needed.
All MCP skill endpoints require session-based authentication through NextAuth. Idle MCP servers are automatically cleaned up.
Activate a skill MCP
POST /api/mcp/:skillId
Starts the MCP server bundled with the specified skill. Returns the server metadata including its name, version, available tools, and activation timestamp.
Path parameters
Parameter
Type
Required
Description
skillId
string
Yes
Identifier of the skill whose MCP server to activate
Built-in skills
The following skills ship with built-in MCP servers:
Failed to deactivate MCP. The error message describes the failure.
Call an MCP tool
POST /api/mcp/:skillId/call/:toolName
Invokes a specific tool on an active MCP server. The skill’s MCP server must be activated before calling its tools.Requires session authentication.
Path parameters
Parameter
Type
Required
Description
skillId
string
Yes
Identifier of the skill whose MCP server to call
toolName
string
Yes
Name of the tool to invoke
Request body
The request body should be a JSON object containing the tool parameters. You can either pass parameters directly as the body or wrap them in a parameters key:
{ "parameters": { "query": "search term" }}
Or directly:
{ "query": "search term"}
An empty body or no body is allowed for tools that take no parameters.
Tool call failed. The response includes success: false and an error message.
500
Failed to call MCP tool. The error message describes the failure.
Automatic idle cleanup
MCP servers that remain idle are automatically deactivated to free resources. You do not need to manually deactivate servers that are no longer in use, though explicit deactivation is recommended when you know a skill’s tools are no longer needed.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Agentbot","colors":{"primary":"#3b82f6","light":"#60a5fa","dark":"#2563eb"},"logo":{"light":"https://mintcdn.com/raveculture/ik6JoSvXFEzkb1q5/logo/agentbot-logo-light.svg?fit=max\u0026auto=format\u0026n=ik6JoSvXFEzkb1q5\u0026q=85\u0026s=ba8dd78b7158d3235900dfebdd9404fe","dark":"https://mintcdn.com/raveculture/ik6JoSvXFEzkb1q5/logo/agentbot-logo-dark.svg?fit=max\u0026auto=format\u0026n=ik6JoSvXFEzkb1q5\u0026q=85\u0026s=278a879bf7d0fca6b3eff9229232ed91"},"favicon":"https://mintcdn.com/raveculture/ZS36l0IlgVilqpNw/favicon.svg?fit=max\u0026auto=format\u0026n=ZS36l0IlgVilqpNw\u0026q=85\u0026s=15c2086453035a7974206b361077ec64","appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#ffffff","dark":"#000000"}},"navbar":{"links":[{"href":"https://agentbot.sh","label":"Agentbot"},{"href":"https://github.com/Eskyee/agentbot-opensource","label":"GitHub"},{"href":"https://discord.gg/vTPG4vdV6D","label":"Discord"},{"href":"https://dev.to/agentbot","label":"Dev.to"},{"href":"https://g.dev/agentbot","label":"Google Dev"},{"href":"https://talent.app/raveculture.base.eth","label":"Talent"},{"href":"https://www.base.dev","label":"Base"},{"href":"https://cerebralvalley.ai/u/Esky","label":"Cerebral Valley"},{"href":"https://buymeacoffee.com/agentbot","label":"☕ Buy Me a Coffee"}]},"footer":{"socials":{"github":"https://github.com/Eskyee/agentbot-opensource","discord":"https://discord.gg/vTPG4vdV6D","website":"https://agentbot.sh"}},"fonts":{"family":"Inter"},"styling":{"codeblocks":"dark","latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"raveculture","hasAudioNarration":false,"actualSubdomain":"raveculture","customDomains":["docs.agentbot.raveculture.xyz"],"gitSource":{"type":"github","owner":"eskyee","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae94a4f00312e79e617bc33:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":86},{"language":"default","tag":"Getting Started","count":9},{"language":"default","tag":"Integrations","count":6},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"Payments","count":4},{"language":"default","tag":"Core Services","count":4},{"language":"default","tag":"MCP","count":1},{"language":"default","tag":"Security","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/mcp-skills","slug":"/api-reference/mcp-skills","pageMetadata":{"title":"MCP skills API","description":"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers","href":"/api-reference/mcp-skills"},"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: \"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`mcp-skills-api`,children:`MCP skills API`}),`\n`,_jsx(_components.p,{children:`Manage skill-embedded MCP servers that provide additional tools to agents. Each skill can bundle its own MCP server with a set of tools. Activate a skill’s MCP server on demand and deactivate it when no longer needed.`}),`\n`,_jsx(Note,{children:`All MCP skill endpoints require session-based authentication through NextAuth. Idle MCP servers are automatically cleaned up.`}),`\n`,_jsx(Heading,{level:`2`,id:`activate-a-skill-mcp`,children:`Activate a skill MCP`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` /api/mcp/:skillId`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Starts the MCP server bundled with the specified skill. Returns the server metadata including its name, version, available tools, and activation timestamp.`}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skillId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Identifier of the skill whose MCP server to activate`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`built-in-skills`,children:`Built-in skills`}),`\n`,_jsx(_components.p,{children:`The following skills ship with built-in MCP servers:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Skill ID`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`websearch`})}),_jsx(_components.td,{children:`Web search tool server`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`context7`})}),_jsx(_components.td,{children:`Context retrieval and semantic search`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`grep_app`})}),_jsx(_components.td,{children:`Code search using grep patterns`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"skillId\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"websearch\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcp\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"websearch-mcp\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"version\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"1.0.0\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"tools\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"web_search\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"web_fetch\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"startedAt\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-04T12:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`success`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Whether activation succeeded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skillId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The skill that was activated`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mcp.name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`MCP server name from the skill configuration`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mcp.version`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`MCP server version`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mcp.tools`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`List of tool names provided by this MCP server`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mcp.startedAt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ISO 8601 timestamp of when the server was started`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Unauthorized — no valid session`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Failed to activate MCP. The error message describes the failure (for example, skill not found or server failed to start).`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`deactivate-a-skill-mcp`,children:`Deactivate a skill MCP`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`DELETE`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` /api/mcp/:skillId`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Stops the MCP server for the specified skill and frees its resources.`}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters-2`,children:`Path parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skillId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Identifier of the skill whose MCP server to deactivate`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-2`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"skillId\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"websearch\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"MCP deactivated\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`success`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Whether deactivation succeeded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skillId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The skill that was deactivated`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`message`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Confirmation message`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`errors-2`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Unauthorized — no valid session`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Failed to deactivate MCP. The error message describes the failure.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`call-an-mcp-tool`,children:`Call an MCP tool`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` /api/mcp/:skillId/call/:toolName`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Invokes a specific tool on an active MCP server. The skill’s MCP server must be activated before calling its tools.`}),`\n`,_jsx(_components.p,{children:`Requires session authentication.`}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters-3`,children:`Path parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skillId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Identifier of the skill whose MCP server to call`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`toolName`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Name of the tool to invoke`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request body`}),`\n`,_jsxs(_components.p,{children:[`The request body should be a JSON object containing the tool parameters. You can either pass parameters directly as the body or wrap them in a `,_jsx(_components.code,{children:`parameters`}),` key:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"parameters\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"query\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"search term\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Or directly:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"query\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"search term\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`An empty body or no body is allowed for tools that take no parameters.`}),`\n`,_jsx(Heading,{level:`3`,id:`response-200`,children:`Response (200)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"skillId\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"websearch\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"toolName\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"web_search\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skillId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The skill that was called`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`toolName`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The tool that was invoked`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`success`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Whether the tool call succeeded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`result`})}),_jsx(_components.td,{children:`any`}),_jsx(_components.td,{children:`Tool-specific result data`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-400`,children:`Response (400)`}),`\n`,_jsx(_components.p,{children:`When the tool call fails (for example, invalid parameters):`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"skillId\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"websearch\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"toolName\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"web_search\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid parameters\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`errors-3`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Unauthorized — no valid session`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`Tool call failed. The response includes `,_jsx(_components.code,{children:`success: false`}),` and an error message.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Failed to call MCP tool. The error message describes the failure.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`automatic-idle-cleanup`,children:`Automatic idle cleanup`}),`\n`,_jsx(_components.p,{children:`MCP servers that remain idle are automatically deactivated to free resources. You do not need to manually deactivate servers that are no longer in use, though explicit deactivation is recommended when you know a skill’s tools are no longer needed.`})]})}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":"dark","config":{},"pageMetadata":{"title":"MCP skills API","description":"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers","href":"/api-reference/mcp-skills"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"MCP skills API","slug":"mcp-skills-api","depth":1,"children":[]},{"title":"Activate a skill MCP","slug":"activate-a-skill-mcp","depth":2,"children":[{"title":"Path parameters","slug":"path-parameters","depth":3,"children":[]},{"title":"Built-in skills","slug":"built-in-skills","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]},{"title":"Errors","slug":"errors","depth":3,"children":[]}]},{"title":"Deactivate a skill MCP","slug":"deactivate-a-skill-mcp","depth":2,"children":[{"title":"Path parameters","slug":"path-parameters-2","depth":3,"children":[]},{"title":"Response","slug":"response-2","depth":3,"children":[]},{"title":"Errors","slug":"errors-2","depth":3,"children":[]}]},{"title":"Call an MCP tool","slug":"call-an-mcp-tool","depth":2,"children":[{"title":"Path parameters","slug":"path-parameters-3","depth":3,"children":[]},{"title":"Request body","slug":"request-body","depth":3,"children":[]},{"title":"Response (200)","slug":"response-200","depth":3,"children":[]},{"title":"Response (400)","slug":"response-400","depth":3,"children":[]},{"title":"Errors","slug":"errors-3","depth":3,"children":[]}]},{"title":"Automatic idle cleanup","slug":"automatic-idle-cleanup","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"raveculture","siteName":"Agentbot","title":"MCP skills API - Agentbot","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-04T23:17:20.753Z","originalFileLocation":"api-reference/mcp-skills.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers\">\u003cmeta data-mint-head name=\"application-name\" content=\"Agentbot\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_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/raveculture/b_KyywdKUVzkNmdA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"MCP skills API - Agentbot\">\u003cmeta data-mint-head property=\"og:description\" content=\"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Agentbot\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://raveculture.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=MCP+skills+API\u0026amp;description=Activate+and+deactivate+skill-embedded+MCP+%28Model+Context+Protocol%29+servers\u0026amp;theme=a1ef4743b3092fc3d19a70e7\u0026amp;signature=fff1d389c44646711b4309ce5d6a701244971ea49f77d637145518b608d4607e\">\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=\"MCP skills API - Agentbot\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://raveculture.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=MCP+skills+API\u0026amp;description=Activate+and+deactivate+skill-embedded+MCP+%28Model+Context+Protocol%29+servers\u0026amp;theme=a1ef4743b3092fc3d19a70e7\u0026amp;signature=fff1d389c44646711b4309ce5d6a701244971ea49f77d637145518b608d4607e\">\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/raveculture/b_KyywdKUVzkNmdA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Agentbot\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3b82f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/mcp-skills.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agentbot.raveculture.xyz/#organization\",\"name\":\"Agentbot\",\"url\":\"https://docs.agentbot.raveculture.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/raveculture/ik6JoSvXFEzkb1q5/logo/agentbot-logo-light.svg?fit=max\u0026auto=format\u0026n=ik6JoSvXFEzkb1q5\u0026q=85\u0026s=ba8dd78b7158d3235900dfebdd9404fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agentbot.raveculture.xyz#website\",\"name\":\"Agentbot\",\"url\":\"https://docs.agentbot.raveculture.xyz\",\"publisher\":{\"@id\":\"https://docs.agentbot.raveculture.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills#webpage\",\"url\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills\",\"name\":\"MCP skills API\",\"description\":\"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers\",\"dateModified\":\"2026-04-04T23:17:20.753Z\",\"isPartOf\":{\"@id\":\"https://docs.agentbot.raveculture.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.agentbot.raveculture.xyz/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP skills API\",\"item\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills#article\",\"headline\":\"MCP skills API\",\"name\":\"MCP skills API\",\"description\":\"Activate and deactivate skill-embedded MCP (Model Context Protocol) servers\",\"url\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agentbot.raveculture.xyz/api-reference/mcp-skills#webpage\"},\"dateModified\":\"2026-04-04T23:17:20.753Z\",\"publisher\":{\"@id\":\"https://docs.agentbot.raveculture.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agentbot.raveculture.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Agentbot\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Agentbot\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/mcp-skills.md","siteName":"Agentbot","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Agentbot Documentation","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Skills","href":"/skills"},{"title":"Architecture","href":"/architecture"},{"title":null,"href":"/channels"},{"title":"AI Models \u0026 Pricing","href":"/models"},{"title":null,"href":"/installation"},{"title":null,"href":"/build"},{"title":null,"href":"/development-standard"},{"title":"Troubleshooting","href":"/troubleshooting"}]},{"group":"Core Concepts","pages":[{"title":null,"href":"/concepts/agents"},{"title":null,"href":"/concepts/workflows"},{"title":"API keys","href":"/concepts/api-keys"},{"title":"Architecture","href":"/concepts/architecture"}]},{"group":"Integrations","pages":[{"title":null,"href":"/channels"},{"title":null,"href":"/integrations/telegram"},{"title":null,"href":"/integrations/discord"},{"title":null,"href":"/integrations/whatsapp"},{"title":"Resend email integration","href":"/integrations/resend"},{"title":"Gitlawb","href":"/integrations/gitlawb"}]},{"group":"Core Services","pages":[{"title":"Data Sources","href":"/services/data-sources"},{"title":"BlockDB","href":"/services/blockdb"},{"title":"Skills Marketplace","href":"/services/skills-marketplace"},{"title":"Base FM Integration","href":"/services/base-fm"}]},{"group":"Payments","pages":[{"title":"Stripe integration","href":"/payments/stripe"},{"title":null,"href":"/payments/x402"},{"title":"MPP payments","href":"/payments/mpp"},{"title":"BTCPay Agentbot","href":"/payments/btcpay"}]},{"group":"API Reference","pages":[{"title":"API reference","href":"/api-reference/overview"},{"title":"Gateway","href":"/api-reference/gateway"},{"title":"Channels API","href":"/api-reference/channels"},{"title":"Sessions API","href":"/api-reference/sessions"},{"title":"Cron API","href":"/api-reference/cron"},{"title":"Agents API","href":"/api-reference/agents"},{"title":"Team provisioning API","href":"/api-reference/team-provisioning"},{"title":"Authentication API","href":"/api-reference/auth"},{"title":"API keys","href":"/api-reference/keys"},{"title":"Wallet API","href":"/api-reference/wallet"},{"title":"Bitcoin wallets","href":"/api-reference/bitcoin-wallets"},{"title":"Liquid network","href":"/api-reference/liquid"},{"title":"Bankr API","href":"/api-reference/bankr"},{"title":"Fee payer API","href":"/api-reference/fee-payer"},{"title":"Metrics API","href":"/api-reference/metrics"},{"title":"Skills API","href":"/api-reference/skills"},{"title":"Calendar API","href":"/api-reference/calendar"},{"title":"Memory API","href":"/api-reference/memory"},{"title":"Files API","href":"/api-reference/files"},{"title":"AI API","description":"AI provider endpoints for model selection, chat completion, and cost estimation","href":"/api-reference/ai"},{"title":"MCP skills API","href":"/api-reference/mcp-skills"},{"title":"Render MCP API","description":"Gateway endpoints for the Render MCP Server integration","href":"/api-reference/render-mcp"},{"title":"Streaming API","href":"/api-reference/streaming"},{"title":"Registration API","href":"/api-reference/registration"},{"title":"Daily brief API","href":"/api-reference/daily-brief"},{"title":"Health API","href":"/api-reference/health"},{"title":"Maintenance API","href":"/api-reference/maintenance"},{"title":"Mission control API","href":"/api-reference/mission-control"},{"title":"Watchdog API","href":"/api-reference/watchdog"},{"title":"Colony API","href":"/api-reference/colony"},{"title":"Workflows API","href":"/api-reference/workflows"},{"title":"Underground API","href":"/api-reference/underground"},{"title":"Invite API","href":"/api-reference/invite"},{"title":"Web summarizer API","href":"/api-reference/web-summarizer"},{"title":"x402 gateway","href":"/api-reference/x402"},{"title":"Demo chat","href":"/api-reference/demo-chat"},{"title":"Signals API","href":"/api-reference/signals"},{"title":"Scheduled tasks API","href":"/api-reference/scheduled-tasks"},{"title":"Billing API","href":"/api-reference/billing"},{"title":"ClawMerchants data feeds","href":"/api-reference/clawmerchants"},{"title":"Dashboard API","href":"/api-reference/dashboard"},{"title":"Debug API","href":"/api-reference/debug"},{"title":"Config API","href":"/api-reference/config"},{"title":"Devices API","href":"/api-reference/devices"},{"title":"Dreams API","href":"/api-reference/dreams"},{"title":"Character QA API","href":"/api-reference/character-qa"},{"title":"Browser automation API","href":"/api-reference/browser"},{"title":"Bridge API","href":"/api-reference/bridge"},{"title":"Permissions API","href":"/api-reference/permissions"},{"title":"Hooks classify","href":"/api-reference/hooks-classify"},{"title":"Orchestration API","href":"/api-reference/orchestration"},{"title":"Hashline","href":"/api-reference/hashline"},{"title":"Init-deep","href":"/api-reference/init-deep"},{"title":"Trial API","href":"/api-reference/trial"},{"title":"Showcase API","href":"/api-reference/showcase"},{"title":"Admin Summary API","href":"/api-reference/admin-summary"},{"title":"Export API","href":"/api-reference/export"},{"title":"Wallet Monitor API","href":"/api-reference/wallet-monitor"},{"title":"Market intel API","href":"/api-reference/market-intel"},{"title":"Referrals API","href":"/api-reference/referrals"},{"title":"Gamification API","href":"/api-reference/gamification"},{"title":"Jobs API","href":"/api-reference/jobs"},{"title":"Platform jobs API","href":"/api-reference/platform-jobs"},{"title":"Gitlawb agents API","href":"/api-reference/gitlawb"},{"title":"Git City API","href":"/api-reference/git-city"},{"title":"Wristband API","href":"/api-reference/wristband"},{"title":"Machine-payable protocol API","href":"/api-reference/mpp"},{"title":"Guestlist API","href":"/api-reference/guestlist"},{"title":"Partner API","href":"/api-reference/partner"},{"title":"Generate video","href":"/api-reference/generate-video"},{"title":"Generate music","href":"/api-reference/generate-music"},{"title":"Buddies API","href":"/api-reference/buddies"},{"title":"Solana API","href":"/api-reference/solana"},{"title":"Claim API","href":"/api-reference/claim"},{"title":"Community Program API","href":"/api-reference/community-program"},{"title":"Community Governance API","href":"/api-reference/community-governance"},{"title":"Community Export API","href":"/api-reference/community-export"},{"title":"Credits API","href":"/api-reference/credits"},{"title":"Feedback API","href":"/api-reference/feedback"},{"title":"Ads campaigns API","href":"/api-reference/ads-campaigns"},{"title":"baseFM identity API","href":"/api-reference/basefm-identity"},{"title":"User X handle API","href":"/api-reference/user-x-handle"},{"title":"Mixtapes API","href":"/api-reference/mixtapes"},{"title":"Outcomes API","href":"/api-reference/outcomes"},{"title":"Social API","href":"/api-reference/social"},{"title":"Live room API","href":"/api-reference/live-room"}]},{"group":"MCP","pages":[{"title":"MCP Server","href":"/mcp"}]},{"group":"Security","pages":[{"title":"Security","href":"/security"}]}]},"basePath":"","title":"MCP skills API - Agentbot","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}