Turn any REST API into agent tools by pointing Clarion at its documentation.
When a system has no Clarion integration and no MCP server, a custom toolset closes the gap. Give Clarion the API’s base URL and its documentation, and it infers the tools — which you then review before any agent sees them.
This is different from a custom MCP server. Use custom MCP when the vendor already ships an MCP server. Use a custom toolset when they don’t.
Create one
In Clarion, open Integrations → Custom toolsets and click Add.
Give it a name — this becomes the tool namespace agents see.
Enter the API’s base URL.
Configure authentication:
Auth
Sends
None
Nothing — for public APIs
Bearer
Authorization: Bearer <token>
Header
A custom header name and value
Basic
Username and password
Query
A key as a query parameter
Provide documentation — paste text, link a URL, or upload a file.
Click Scan. Clarion reads the docs and proposes a list of tools.
Credentials are encrypted at rest and attached to the request outside the sandbox, so an agent never sees the key it is authenticating with.
Review before enabling
The inferred tool list is a proposal, not a live surface. Every tool is disabled until you enable it, and only enabled tools are exposed to agents. Review each one’s name, description, and parameters before turning it on — the description is what an agent reasons about when deciding to call it.
Enable the narrowest set that does the job, and be deliberate about anything that writes. A tool an agent can call is a tool an agent can be talked into calling.
Responses pass through secret redaction before they reach a transcript or the UI.
Rescans
Clarion hashes the normalized documentation. Rescanning after an unchanged doc is a no-op; when the docs change, you get a fresh proposal to review rather than silent drift in what your agents can do.
Use in skills
Once enabled, a custom toolset’s tools appear in the skill editor’s tool picker like any other integration’s, and can be embedded in skill content.
Delete
Delete the toolset from Integrations → Custom toolsets. Stored credentials are removed, and skills referencing its tools surface them as missing.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cantina Documentation","colors":{"primary":"#DB4E11","light":"#F06A32","dark":"#A9380C"},"logo":{"light":"https://mintcdn.com/cantina/tgEekvUexOAC2gco/logo/light.svg?fit=max\u0026auto=format\u0026n=tgEekvUexOAC2gco\u0026q=85\u0026s=501ef0f8eaa0da5329fcd2fcd93143f4","dark":"https://mintcdn.com/cantina/tgEekvUexOAC2gco/logo/dark.svg?fit=max\u0026auto=format\u0026n=tgEekvUexOAC2gco\u0026q=85\u0026s=4b61984ecb438713afdd62d82740395e"},"favicon":"https://mintcdn.com/cantina/FmHlNC94qPGzvjfL/favicon.svg?fit=max\u0026auto=format\u0026n=FmHlNC94qPGzvjfL\u0026q=85\u0026s=a7040063242737a909ec600ee58b971e","background":{"image":{"light":"https://mintcdn.com/cantina/AP2w605nRxe1AmJZ/background-light.svg?fit=max\u0026auto=format\u0026n=AP2w605nRxe1AmJZ\u0026q=85\u0026s=ad8ad733e8e3b4924e61c625aa254cae","dark":"https://mintcdn.com/cantina/AP2w605nRxe1AmJZ/background-dark.svg?fit=max\u0026auto=format\u0026n=AP2w605nRxe1AmJZ\u0026q=85\u0026s=2f37b72a15b9f94b3d12b09eb0c3ec10"},"color":{"light":"#F5EFE4","dark":"#06161E"}},"navbar":{"links":[{"href":"https://www.cantina.security/","label":"Website"},{"href":"mailto:support@cantina.security","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/cantinasecurity","github":"https://github.com/cantina-fyi","linkedin":"https://www.linkedin.com/company/cantinasecurity"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cantina","hasAudioNarration":false,"actualSubdomain":"cantina","customDomains":["docs.cantina.security"],"gitSource":{"type":"github","owner":"spearbit","repo":"cantina-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af73a4f9b8f20269efb4dde","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Documentation","count":155},{"language":"default","tag":"Products","count":93},{"language":"default","tag":"Clarion","count":85},{"language":"default","tag":"Integrations","count":69},{"language":"default","tag":"For Security Researchers","count":19},{"language":"default","tag":"For Security Teams","count":19},{"language":"default","tag":"Participation Guides","count":11},{"language":"default","tag":"Learn","count":10},{"language":"default","tag":"Security Solutions","count":10},{"language":"default","tag":"Apex","count":8}]},"assistantConfig":{},"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":"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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[{"filePath":"style.css","content":"#background-color{z-index:-10!important;pointer-events:none!important}span.fixed.inset-0.pointer-events-none{background-size:cover!important;background-position:top right!important;background-repeat:no-repeat!important;background-attachment:fixed!important}#navbar,#sidebar,#sidebar-content,#table-of-contents,#table-of-contents-content{background-color:rgb(var(--background-light) / 0.97)}:is(.dark) #navbar,:is(.dark) #table-of-contents,:is(.dark) #table-of-contents-content,.dark #navbar,.dark #table-of-contents,.dark #table-of-contents-content{background-color:rgb(var(--background-dark) / 0.55)}:is(.dark) #sidebar,.dark #sidebar{background-color:transparent!important;background-image:linear-gradient(\n to bottom,\n rgb(var(--background-dark) / 0.28) 0%,\n rgb(var(--background-dark) / 0.5) 28%,\n rgb(var(--background-dark) / 0.68) 55%,\n rgb(var(--background-dark) / 0.72) 100%\n )!important;-webkit-mask-image:linear-gradient(\n to right,\n #000 0%,\n #000 calc(100% - 22px),\n transparent 100%\n );mask-image:linear-gradient(\n to right,\n #000 0%,\n #000 calc(100% - 22px),\n transparent 100%\n )}:is(.dark) #sidebar-content,.dark #sidebar-content{background-color:transparent!important}:is(.dark) #navbar-transition,.dark #navbar-transition{border-bottom-color:transparent!important;border-color:transparent!important}:is(.dark) #navbar,:is(.dark) #sidebar,:is(.dark) #sidebar-content,:is(.dark) #table-of-contents,:is(.dark) #table-of-contents-content,:is(.dark) #content-area,.dark #navbar,.dark #sidebar,.dark #sidebar-content,.dark #table-of-contents,.dark #table-of-contents-content,.dark #content-area{border-color:transparent!important;box-shadow:none!important}:is(.dark) #sidebar button,:is(.dark) #sidebar .nav-dropdown-item-icon,:is(.dark) #navbar button,.dark #sidebar button,.dark #sidebar .nav-dropdown-item-icon,.dark #navbar button{border-color:transparent!important;box-shadow:none!important}"}]}
{"page":{"pagePath":"clarion/integrations/custom-toolset","slug":"/clarion/integrations/custom-toolset","pageMetadata":{"title":"Custom toolset (API)","description":"Turn any REST API into agent tools by pointing Clarion at its documentation.","href":"/clarion/integrations/custom-toolset"},"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: \"Turn any REST API into agent tools by pointing Clarion at its documentation.\"\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={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When a system has no Clarion integration and no MCP server, a `,_jsx(_components.strong,{children:`custom toolset`}),` closes the gap. Give Clarion the API’s base URL and its documentation, and it infers the tools — which you then review before any agent sees them.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This is different from a `,_jsx(_components.a,{href:`/clarion/integrations/custom-mcp`,children:`custom MCP server`}),`. Use custom MCP when the vendor already ships an MCP server. Use a custom toolset when they don’t.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`create-one`,children:`Create one`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In Clarion, open `,_jsx(_components.strong,{children:`Integrations → Custom toolsets`}),` and click `,_jsx(_components.strong,{children:`Add`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Give it a `,_jsx(_components.strong,{children:`name`}),` — this becomes the tool namespace agents see.`]}),`\n`,_jsxs(_components.li,{children:[`Enter the API’s `,_jsx(_components.strong,{children:`base URL`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Configure `,_jsx(_components.strong,{children:`authentication`}),`:`]}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Auth`}),_jsx(_components.th,{children:`Sends`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`None`})}),_jsx(_components.td,{children:`Nothing — for public APIs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Bearer`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization: Bearer \u003ctoken>`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Header`})}),_jsx(_components.td,{children:`A custom header name and value`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Basic`})}),_jsx(_components.td,{children:`Username and password`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Query`})}),_jsx(_components.td,{children:`A key as a query parameter`})]})]})]}),`\n`,_jsxs(_components.ol,{start:`5`,children:[`\n`,_jsxs(_components.li,{children:[`Provide `,_jsx(_components.strong,{children:`documentation`}),` — paste text, link a URL, or upload a file.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Scan`}),`. Clarion reads the docs and proposes a list of tools.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Credentials are encrypted at rest and attached to the request outside the sandbox, so an agent never sees the key it is authenticating with.`}),`\n`,_jsx(Heading,{level:`2`,id:`review-before-enabling`,children:`Review before enabling`}),`\n`,_jsxs(_components.p,{children:[`The inferred tool list is a `,_jsx(_components.strong,{children:`proposal`}),`, not a live surface. Every tool is disabled until you enable it, and only enabled tools are exposed to agents. Review each one’s name, description, and parameters before turning it on — the description is what an agent reasons about when deciding to call it.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Enable the narrowest set that does the job, and be deliberate about anything that writes. A tool an agent can call is a tool an agent can be talked into calling.`})}),`\n`,_jsx(_components.p,{children:`Responses pass through secret redaction before they reach a transcript or the UI.`}),`\n`,_jsx(Heading,{level:`2`,id:`rescans`,children:`Rescans`}),`\n`,_jsx(_components.p,{children:`Clarion hashes the normalized documentation. Rescanning after an unchanged doc is a no-op; when the docs change, you get a fresh proposal to review rather than silent drift in what your agents can do.`}),`\n`,_jsx(Heading,{level:`2`,id:`use-in-skills`,children:`Use in skills`}),`\n`,_jsx(_components.p,{children:`Once enabled, a custom toolset’s tools appear in the skill editor’s tool picker like any other integration’s, and can be embedded in skill content.`}),`\n`,_jsx(Heading,{level:`2`,id:`delete`,children:`Delete`}),`\n`,_jsxs(_components.p,{children:[`Delete the toolset from `,_jsx(_components.strong,{children:`Integrations → Custom toolsets`}),`. Stored credentials are removed, and skills referencing its tools surface them as missing.`]})]})}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":{"config":{},"pageMetadata":{"title":"Custom toolset (API)","description":"Turn any REST API into agent tools by pointing Clarion at its documentation.","href":"/clarion/integrations/custom-toolset"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create one","slug":"create-one","depth":2,"children":[]},{"title":"Review before enabling","slug":"review-before-enabling","depth":2,"children":[]},{"title":"Rescans","slug":"rescans","depth":2,"children":[]},{"title":"Use in skills","slug":"use-in-skills","depth":2,"children":[]},{"title":"Delete","slug":"delete","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cantina","siteName":"Cantina Documentation","title":"Custom toolset (API) - Cantina Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T15:11:35.069Z","originalFileLocation":"clarion/integrations/custom-toolset.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=\"Turn any REST API into agent tools by pointing Clarion at its documentation.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cantina 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/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_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/cantina/e46l_1vpQTNpB2S9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Custom toolset (API) - Cantina Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Turn any REST API into agent tools by pointing Clarion at its documentation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cantina Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cantina.security/clarion/integrations/custom-toolset\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cantina.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=Custom+toolset+%28API%29\u0026amp;description=Turn+any+REST+API+into+agent+tools+by+pointing+Clarion+at+its+documentation.\u0026amp;theme=90d6f2cacec23e54ce113d35\u0026amp;signature=fb468f87fdb0937c2a6c9be819df2100a2d6b90829c125b6f171717252e08544\">\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=\"Custom toolset (API) - Cantina Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Turn any REST API into agent tools by pointing Clarion at its documentation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cantina.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=Custom+toolset+%28API%29\u0026amp;description=Turn+any+REST+API+into+agent+tools+by+pointing+Clarion+at+its+documentation.\u0026amp;theme=90d6f2cacec23e54ce113d35\u0026amp;signature=fb468f87fdb0937c2a6c9be819df2100a2d6b90829c125b6f171717252e08544\">\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/cantina/e46l_1vpQTNpB2S9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cantina Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DB4E11\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cantina.security/clarion/integrations/custom-toolset\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/clarion/integrations/custom-toolset.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cantina.security/#organization\",\"name\":\"Cantina Documentation\",\"url\":\"https://docs.cantina.security\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cantina/tgEekvUexOAC2gco/logo/light.svg?fit=max\u0026auto=format\u0026n=tgEekvUexOAC2gco\u0026q=85\u0026s=501ef0f8eaa0da5329fcd2fcd93143f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cantina.security#website\",\"name\":\"Cantina Documentation\",\"url\":\"https://docs.cantina.security\",\"publisher\":{\"@id\":\"https://docs.cantina.security/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cantina.security/clarion/integrations/custom-toolset#webpage\",\"url\":\"https://docs.cantina.security/clarion/integrations/custom-toolset\",\"name\":\"Custom toolset (API)\",\"description\":\"Turn any REST API into agent tools by pointing Clarion at its documentation.\",\"dateModified\":\"2026-11-13T15:11:35.069Z\",\"isPartOf\":{\"@id\":\"https://docs.cantina.security#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cantina.security/clarion/integrations/custom-toolset#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cantina.security/clarion/integrations/custom-toolset#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Products\",\"item\":\"https://docs.cantina.security/apex\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Clarion\",\"item\":\"https://docs.cantina.security/clarion\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Integrations\",\"item\":\"https://docs.cantina.security/clarion/integrations/aws\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Custom toolset (API)\",\"item\":\"https://docs.cantina.security/clarion/integrations/custom-toolset\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cantina.security/clarion/integrations/custom-toolset#article\",\"headline\":\"Custom toolset (API)\",\"name\":\"Custom toolset (API)\",\"description\":\"Turn any REST API into agent tools by pointing Clarion at its documentation.\",\"url\":\"https://docs.cantina.security/clarion/integrations/custom-toolset\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cantina.security/clarion/integrations/custom-toolset#webpage\"},\"dateModified\":\"2026-11-13T15:11:35.069Z\",\"publisher\":{\"@id\":\"https://docs.cantina.security/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cantina.security#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cantina Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cantina Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/clarion/integrations/custom-toolset.md","siteName":"Cantina Documentation","nav":{"global":null,"dropdowns":[{"dropdown":"Documentation","icon":"book","description":"Cantina Documentation","groups":[{"group":"Introduction","pages":[{"title":"Welcome to Cantina","href":"/introduction"},{"title":"How Cantina works: the loop","href":"/how-it-works"},{"title":"Vision and approach","href":"/vision-and-approach"},{"title":"Use Cantina with AI agents","href":"/agent-resources"}]},{"group":"Platform Overview","pages":[{"title":"Platform overview","href":"/platform/overview"},{"title":"The security loop","href":"/platform/the-loop"},{"title":"Products at a glance","href":"/platform/products"},{"title":"Trust, auditability, and human control","href":"/platform/trust"}]},{"group":"Products","pages":[{"group":"Apex","pages":[{"title":"Apex AI penetration testing and code security","href":"/apex"},{"title":"AI penetration testing and code security","href":"/apex/penetration-testing"},{"title":"Client onboarding guide","href":"/apex/onboarding"},{"title":"Apex scan manual","href":"/apex/scan-manual"},{"title":"Scheduled scans","href":"/apex/scheduled-scans"},{"title":"Apex CLI guide","href":"/apex/cli"},{"title":"Apex service API","href":"/apex/api"},{"title":"Apex API agent environment","href":"/apex/api-agent-environment"}]},{"group":"Clarion","pages":[{"group":"Getting Started","pages":[{"title":"Clarion security operations documentation","href":"/clarion"},{"title":"Getting started","href":"/clarion/getting-started"}]},{"group":"Easy ROI","pages":[{"title":"Measuring your ROI","href":"/clarion/roi/measuring-roi"},{"title":"Getting the most value","href":"/clarion/roi/getting-the-most-value"}]},{"group":"Knowledge Base","pages":[{"title":"Knowledge base","href":"/clarion/knowledge-base"}]},{"group":"Learn","pages":[{"title":"Introduction","href":"/clarion/learn"},{"title":"Issues","href":"/clarion/learn/issues"},{"title":"Signals","href":"/clarion/learn/signals"},{"title":"Tasks","href":"/clarion/learn/tasks"},{"title":"Agents","href":"/clarion/learn/agents"},{"title":"Skills","href":"/clarion/learn/skills"},{"title":"Tools","href":"/clarion/learn/tools"},{"title":"AI chat","href":"/clarion/learn/chat"},{"title":"Notifications","href":"/clarion/learn/notifications"},{"title":"Settings","href":"/clarion/learn/settings"}]},{"group":"Integrations","pages":[{"group":"AWS","pages":[{"title":"AWS","href":"/clarion/integrations/aws"},{"title":"EventBridge and SNS","href":"/clarion/integrations/aws/eventbridge"},{"title":"CloudTrail via existing S3 bucket","href":"/clarion/integrations/aws/cloudtrail-s3"}]},{"group":"Google Cloud","pages":[{"title":"Google Cloud","href":"/clarion/integrations/google-cloud"},{"title":"Cloud Logging","href":"/clarion/integrations/google-cloud/cloud-logging"},{"title":"Cloud Monitoring","href":"/clarion/integrations/google-cloud/cloud-monitoring"},{"title":"Security Command Center","href":"/clarion/integrations/google-cloud/security-command-center"}]},{"group":"Cloudflare","pages":[{"title":"Cloudflare","href":"/clarion/integrations/cloudflare"},{"title":"Logpush","href":"/clarion/integrations/cloudflare/logpush"}]},{"group":"Threat Intel","pages":[{"title":"Threat Intel","href":"/clarion/integrations/threat-intel"},{"title":"Webhook","href":"/clarion/integrations/threat-intel/webhook"},{"title":"RSS Feed","href":"/clarion/integrations/threat-intel/rss-feed"}]},{"title":"Okta","href":"/clarion/integrations/okta"},{"title":"Microsoft Entra ID","href":"/clarion/integrations/microsoft-entra-id"},{"title":"Microsoft Sentinel","href":"/clarion/integrations/microsoft-sentinel"},{"title":"Microsoft SharePoint","href":"/clarion/integrations/microsoft-sharepoint"},{"title":"Microsoft Teams","href":"/clarion/integrations/microsoft-teams"},{"title":"Google Workspace","href":"/clarion/integrations/google-workspace"},{"title":"Google Calendar","href":"/clarion/integrations/google-calendar"},{"title":"JumpCloud","href":"/clarion/integrations/jumpcloud"},{"title":"1Password","href":"/clarion/integrations/1password"},{"title":"NinjaOne","href":"/clarion/integrations/ninjaone"},{"title":"Swif","href":"/clarion/integrations/swif"},{"title":"Vanta","href":"/clarion/integrations/vanta"},{"title":"CrowdStrike Falcon","href":"/clarion/integrations/crowdstrike"},{"title":"SentinelOne","href":"/clarion/integrations/sentinelone"},{"title":"Huntress","href":"/clarion/integrations/huntress"},{"title":"Microsoft Defender XDR","href":"/clarion/integrations/microsoft-defender-xdr"},{"title":"Wiz","href":"/clarion/integrations/wiz"},{"title":"Falco","href":"/clarion/integrations/falco"},{"title":"Splunk","href":"/clarion/integrations/splunk"},{"title":"Datadog","href":"/clarion/integrations/datadog"},{"title":"Grafana","href":"/clarion/integrations/grafana"},{"title":"Better Stack","href":"/clarion/integrations/betterstack"},{"title":"Status Page","href":"/clarion/integrations/status-page"},{"title":"DNS Monitor","href":"/clarion/integrations/dns"},{"title":"Envoy","href":"/clarion/integrations/envoy"},{"title":"Hypernative","href":"/clarion/integrations/hypernative"},{"title":"Hexagate","href":"/clarion/integrations/hexagate"},{"title":"Tenderly","href":"/clarion/integrations/tenderly"},{"title":"Guardrail","href":"/clarion/integrations/guardrail"},{"title":"Cantina Bug Bounty","href":"/clarion/integrations/cantina-bbp"},{"title":"Iru","href":"/clarion/integrations/iru"},{"title":"Apex","href":"/clarion/integrations/apex"},{"title":"NightVision","href":"/clarion/integrations/nightvision"},{"title":"GitHub","href":"/clarion/integrations/github"},{"title":"Vercel","href":"/clarion/integrations/vercel"},{"title":"Supabase","href":"/clarion/integrations/supabase"},{"title":"Replit","href":"/clarion/integrations/replit"},{"title":"Jira","href":"/clarion/integrations/jira"},{"title":"Linear","href":"/clarion/integrations/linear"},{"title":"Pylon","href":"/clarion/integrations/pylon"},{"title":"Notion","href":"/clarion/integrations/notion"},{"title":"Confluence","href":"/clarion/integrations/confluence"},{"title":"Slack","href":"/clarion/integrations/slack"},{"title":"Telegram Notifications","href":"/clarion/integrations/telegram"},{"title":"Telegram Chats","href":"/clarion/integrations/telegram-chats"},{"title":"Twilio (SMS \u0026 phone)","href":"/clarion/integrations/twilio"},{"title":"PagerDuty","href":"/clarion/integrations/pagerduty"},{"title":"incident.io","href":"/clarion/integrations/incident-io"},{"title":"Halo","href":"/clarion/integrations/halo"},{"title":"Tailscale","href":"/clarion/integrations/tailscale"},{"title":"Zscaler","href":"/clarion/integrations/zscaler"},{"title":"Generic Webhook","href":"/clarion/integrations/generic-webhook"},{"title":"Custom MCP","description":"Connect any MCP-compatible HTTP server to extend Clarion agents with your own tools.","href":"/clarion/integrations/custom-mcp"},{"title":"Custom toolset (API)","href":"/clarion/integrations/custom-toolset"},{"title":"Claude Code","description":"Ingest OpenTelemetry from your developers' Claude Code installs to govern MCP servers, spot external accounts, and catch credential-shaped tool use.","href":"/clarion/integrations/claude-code"},{"title":"Devin","href":"/clarion/integrations/devin"},{"title":"OpenClaw","href":"/clarion/integrations/openclaw"}]},{"group":"Terms","pages":[{"title":"Clarion Terms of Service","href":"/resources/clarion-terms"}]}]}]},{"group":"For Security Teams","pages":[{"group":"Getting Started","pages":[{"title":"Getting Started with Cantina","href":"/security-teams/getting-started"},{"title":"API Access","href":"/security-teams/getting-started/api-access"},{"title":"SSO Configuration","href":"/security-teams/getting-started/sso"}]},{"group":"Security Solutions","pages":[{"title":"Security solutions","href":"/security-teams/services"},{"title":"Smart Contract Security Audits","href":"/security-teams/services/smart-contract-audits"},{"title":"Application Security Audits","href":"/security-teams/services/application-security-audits"},{"title":"Competitions","href":"/security-teams/services/competitions"},{"title":"Bug Bounty","href":"/security-teams/services/bug-bounty"},{"title":"Penetration Testing","href":"/security-teams/services/penetration-testing"},{"title":"Managed Detection and Response","href":"/security-teams/services/managed-detection-and-response"},{"title":"Advisory","href":"/security-teams/services/advisory"},{"title":"Multisig Security","href":"/security-teams/services/multisig-security"},{"title":"How Cantina Audits Work","href":"/security-teams/services/how-audits-work"}]},{"group":"Cantina Code","pages":[{"title":"Cantina Code for Companies","href":"/security-teams/cantina-code"},{"title":"Managing Findings","href":"/security-teams/cantina-code/managing-findings"},{"title":"Working with Reports","href":"/security-teams/cantina-code/working-with-reports"}]},{"group":"Community","pages":[{"title":"Building agents on the platform","href":"/security-teams/community/building-agents"},{"title":"Sharing and reusing","href":"/security-teams/community/sharing"},{"title":"Community guidelines","href":"/security-teams/community/guidelines"}]}]},{"group":"For Security Researchers","pages":[{"group":"Joining Cantina","pages":[{"title":"Joining Cantina","href":"/researchers/joining"},{"title":"KYC and Payments","href":"/researchers/joining/kyc"},{"title":"Payout Process","href":"/researchers/joining/payout-process"}]},{"group":"Participation Guides","pages":[{"title":"Participation Guides","href":"/researchers/participation"},{"title":"Bug Bounty","href":"/researchers/participation/bounties"},{"title":"New Bounty Platform","href":"/researchers/participation/new-bounty-platform"},{"title":"Bug Bounty Participation","href":"/researchers/participation/bug-bounty"},{"title":"Bug Bounty Finding Statuses","href":"/researchers/participation/bug-bounty-statuses"},{"title":"Bug Bounty Payout","href":"/researchers/participation/bug-bounty-payouts"},{"title":"Deposits for Bounty Submissions","href":"/researchers/participation/deposits"},{"title":"Competition Participation","href":"/researchers/participation/competitions"},{"title":"Submission Guidelines","href":"/researchers/participation/submission-guidelines"},{"title":"Finding Submission Examples","href":"/researchers/participation/examples"},{"title":"Security Review Process","href":"/researchers/participation/security-review-process"}]},{"group":"Cantina Tools","pages":[{"title":"Cantina Tools","href":"/researchers/tools"},{"title":"Communication Features","href":"/researchers/tools/features"},{"title":"Cantina Code Usage","href":"/researchers/tools/cantina-code"}]},{"group":"Researcher Resources","pages":[{"title":"Researcher Resources","href":"/researchers/resources"},{"title":"Competitions","sidebarTitle":"Competitions (quick links)","href":"/researchers/competitions"}]}]},{"group":"Evaluations \u0026 Standards","pages":[{"title":"Evaluations and Standards","href":"/standards"},{"group":"Severity Classifications","pages":[{"title":"Severity Classifications","href":"/standards/severity"},{"title":"Bug Bounty Severity Classification","href":"/standards/severity/bug-bounty"},{"title":"Competition Finding Severity Criteria","href":"/standards/severity/competition"},{"title":"Finding Labels and Status","href":"/standards/severity/finding-categorization"}]},{"title":"Judging Processes","href":"/standards/judging"}]},{"group":"Referral Program","pages":[{"title":"Referral Program","href":"/referrals"}]},{"group":"Resources","pages":[{"title":"FAQ","href":"/resources/faq"},{"title":"Changelog","href":"/resources/changelog"},{"title":"Public Reports","href":"/resources/public-reports"},{"title":"Links","href":"/resources/links"},{"title":"Clarion Privacy \u0026 Legal Disclosures","href":"/resources/legal"},{"title":"Cantina Community Code of Conduct","href":"/resources/code-of-conduct"},{"title":"Support","href":"/resources/support"}]},{"group":"API Reference","pages":[{"title":"Client API Reference","href":"/api"},{"title":"MCP access","href":"/api/mcp-access"}]}]}]},"basePath":"","title":"Custom toolset (API) - Cantina Documentation","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}