Every request to the MCP server must be authenticated with a Antinuous API key. A key
identifies your organization — all tool calls run scoped to that org’s data and connected
integrations.
The full key is shown only once, at creation. Store it securely.
Only a short prefix (e.g. sg_live_ab12…) is ever displayed afterward, so you can tell keys apart.
Keys don’t expire, but you can revoke any key at any time. Revocation takes effect immediately.
Use a separate key per integration or environment (e.g. one for production, one for local
testing). That way you can revoke a single key without disrupting everything else.
A key only ever accesses the organization it was created for.
Async runs (GTM audits, org audits) are also scoped to
the org: polling a run id that belongs to another org returns not found.
Which tools return enriched results depends on the integrations connected to your org. Check
with list_capabilities.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Antinuous","description":"Connect any MCP client or agent to Antinuous's GTM research and audit tools.","colors":{"primary":"#132101","light":"#d4e052","dark":"#132101"},"logo":{"light":"https://mintcdn.com/salesgraph/isc7153Px1ezBydN/logo/light.svg?fit=max\u0026auto=format\u0026n=isc7153Px1ezBydN\u0026q=85\u0026s=960d9f288268f48183591d23942cafe6","dark":"https://mintcdn.com/salesgraph/isc7153Px1ezBydN/logo/dark.svg?fit=max\u0026auto=format\u0026n=isc7153Px1ezBydN\u0026q=85\u0026s=42cfcdc8dfe3ae55127ab7dcd52b0be2","href":"https://salesgraph.com"},"favicon":"https://mintcdn.com/salesgraph/isc7153Px1ezBydN/favicon.svg?fit=max\u0026auto=format\u0026n=isc7153Px1ezBydN\u0026q=85\u0026s=ecafbc7d528d375941a8a573f997042e","appearance":{"default":"light","strict":true},"background":{"color":{"light":"#fffdf7","dark":"#fffdf7"}},"navbar":{"links":[{"href":"mailto:support@salesgraph.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://salesgraph.com/dashboard/settings/api-keys"}},"footer":{"socials":{"website":"https://salesgraph.com","x":"https://x.com/salesgraph"}},"fonts":{"heading":{"family":"TWK Ghost","weight":400,"source":"fonts/ghost/web/woff2/TWKGhost-Medium.woff2","format":"woff2"},"body":{"family":"Public Sans"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"salesgraph","hasAudioNarration":false,"actualSubdomain":"salesgraph","customDomains":["docs.salesgraph.com"],"gitSource":{"type":"github","owner":"antinuous","repo":"zeus","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6abd7d35918fa7a19e5a8aa7","collectionId":"deef9088-9603-479c-937a-602ad86bf536","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6abd7d35918fa7a19e5a8aa7"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6abd7d35918fa7a19e5a8aa7","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Tools","count":8},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Connect a client","count":3},{"language":"default","tag":"Reference","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".chat-assistant-floating-input>div>div.rounded-2xl{background-color:#fff}::selection{background-color:#d4e052;color:#132101}.rounded-2xl,.rounded-3xl,.rounded-lg,.rounded-xl{border-radius:.25rem!important}h1,h2,h3,h4,h5,h6{color:#132101}"}],"page":{"pagePath":"authentication","slug":"/authentication","pageMetadata":{"title":"Authentication","description":"How Antinuous API keys work and how to send them.","href":"/authentication"},"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: \"How Antinuous API keys work and how to send them.\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every request to the MCP server must be authenticated with a Antinuous API key. A key\nidentifies your `,_jsx(_components.strong,{children:`organization`}),` — all tool calls run scoped to that org’s data and connected\nintegrations.`]}),`\n`,_jsx(Heading,{level:`2`,id:`api-keys`,children:`API keys`}),`\n`,_jsxs(_components.p,{children:[`Keys are created and revoked from `,_jsx(_components.a,{href:`https://salesgraph.com/dashboard/settings/api-keys`,children:`Settings → API Keys`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Keys are prefixed with `,_jsx(_components.code,{children:`sg_live_`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The full key is shown `,_jsx(_components.strong,{children:`only once`}),`, at creation. Store it securely.`]}),`\n`,_jsxs(_components.li,{children:[`Only a short prefix (e.g. `,_jsx(_components.code,{children:`sg_live_ab12…`}),`) is ever displayed afterward, so you can tell keys apart.`]}),`\n`,_jsx(_components.li,{children:`Keys don’t expire, but you can revoke any key at any time. Revocation takes effect immediately.`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Use a separate key per integration or environment (e.g. one for production, one for local\ntesting). That way you can revoke a single key without disrupting everything else.`})}),`\n`,_jsx(Heading,{level:`2`,id:`sending-the-key`,children:`Sending the key`}),`\n`,_jsx(_components.p,{children:`Send your key on every request using either header:`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Authorization (recommended)`,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--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:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer sg_live_xxxxxxxxxxxx`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`x-api-key`,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--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:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-api-key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sg_live_xxxxxxxxxxxx`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`Most MCP clients have a dedicated field for the URL and a place to add a custom header — use\nthe `,_jsx(_components.code,{children:`Authorization: Bearer \u003ckey>`}),` form there.`]}),`\n`,_jsx(Heading,{level:`2`,id:`unauthorized-responses`,children:`Unauthorized responses`}),`\n`,_jsx(_components.p,{children:`A missing, malformed, or revoked key returns:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unauthorized\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`with HTTP status `,_jsx(_components.code,{children:`401`}),` and a `,_jsx(_components.code,{children:`WWW-Authenticate: Bearer`}),` header.`]}),`\n`,_jsx(Heading,{level:`2`,id:`scope-and-isolation`,children:`Scope and isolation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A key only ever accesses the organization it was created for.`}),`\n`,_jsxs(_components.li,{children:[`Async runs (`,_jsx(_components.a,{href:`/tools/gtm-audit`,children:`GTM audits`}),`, `,_jsx(_components.a,{href:`/tools/org-audit`,children:`org audits`}),`) are also scoped to\nthe org: polling a run id that belongs to another org returns `,_jsx(_components.code,{children:`not found`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Which tools return enriched results depends on the integrations connected to your org. Check\nwith `,_jsx(_components.a,{href:`/tools/list-capabilities`,children:_jsx(_components.code,{children:`list_capabilities`})}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Authentication","description":"How Antinuous API keys work and how to send them.","href":"/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"API keys","slug":"api-keys","depth":2,"children":[]},{"title":"Sending the key","slug":"sending-the-key","depth":2,"children":[]},{"title":"Unauthorized responses","slug":"unauthorized-responses","depth":2,"children":[]},{"title":"Scope and isolation","slug":"scope-and-isolation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"salesgraph","siteName":"Antinuous","title":"Authentication - Antinuous","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T21:11:52.360Z","originalFileLocation":"authentication.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"How Antinuous API keys work and how to send them.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Antinuous\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_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/salesgraph/5wfjRYmE_tiMrL0W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Antinuous\">\u003cmeta data-mint-head property=\"og:description\" content=\"How Antinuous API keys work and how to send them.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Antinuous\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.salesgraph.com/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://salesgraph.mintlify.app/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Authentication\u0026amp;description=How+Antinuous+API+keys+work+and+how+to+send+them.\u0026amp;theme=884c8dfd7e250372ee7e3481\u0026amp;signature=f4b55b1a77caebcb29f54b33a883197b43414a2cdb1a5d78dda5dd27130cd0a3\">\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=\"Authentication - Antinuous\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How Antinuous API keys work and how to send them.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://salesgraph.mintlify.app/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Authentication\u0026amp;description=How+Antinuous+API+keys+work+and+how+to+send+them.\u0026amp;theme=884c8dfd7e250372ee7e3481\u0026amp;signature=f4b55b1a77caebcb29f54b33a883197b43414a2cdb1a5d78dda5dd27130cd0a3\">\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/salesgraph/5wfjRYmE_tiMrL0W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Antinuous\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#132101\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.salesgraph.com/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.salesgraph.com/#organization\",\"name\":\"Antinuous\",\"url\":\"https://docs.salesgraph.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/salesgraph/isc7153Px1ezBydN/logo/light.svg?fit=max\u0026auto=format\u0026n=isc7153Px1ezBydN\u0026q=85\u0026s=960d9f288268f48183591d23942cafe6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.salesgraph.com#website\",\"name\":\"Antinuous\",\"url\":\"https://docs.salesgraph.com\",\"publisher\":{\"@id\":\"https://docs.salesgraph.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.salesgraph.com/authentication#webpage\",\"url\":\"https://docs.salesgraph.com/authentication\",\"name\":\"Authentication\",\"description\":\"How Antinuous API keys work and how to send them.\",\"dateModified\":\"2026-09-24T21:11:52.360Z\",\"isPartOf\":{\"@id\":\"https://docs.salesgraph.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.salesgraph.com/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.salesgraph.com/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://docs.salesgraph.com/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.salesgraph.com/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.salesgraph.com/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"How Antinuous API keys work and how to send them.\",\"url\":\"https://docs.salesgraph.com/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.salesgraph.com/authentication#webpage\"},\"dateModified\":\"2026-09-24T21:11:52.360Z\",\"publisher\":{\"@id\":\"https://docs.salesgraph.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.salesgraph.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Antinuous\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Antinuous","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"Antinuous MCP","href":""},{"title":"Quickstart","description":"Create an API key and make your first tool call.","href":"/quickstart"},{"title":"Authentication","href":"/authentication"}]},{"group":"Connect a client","pages":[{"title":"Connect Claude","description":"Add the Antinuous MCP server to Claude Desktop or Claude Code.","href":"/clients/claude"},{"title":"Connect Cursor","href":"/clients/cursor"},{"title":"Raw HTTP","href":"/clients/http"}]},{"group":"Tools","pages":[{"title":"Tools overview","href":"/tools/overview"},{"title":"research","href":"/tools/research"},{"title":"competitors","href":"/tools/competitors"},{"title":"gtm_audit","href":"/tools/gtm-audit"},{"title":"org_audit","href":"/tools/org-audit"},{"title":"get_run_status","href":"/tools/get-run-status"},{"title":"list_capabilities","href":"/tools/list-capabilities"},{"title":"help","href":"/tools/help"}]},{"group":"Reference","pages":[{"title":"Async runs","href":"/reference/async-runs"},{"title":"Errors \u0026 limits","href":"/reference/errors"},{"title":"REST API","href":"/reference/rest-api"}]}]}]},"title":"Authentication - Antinuous","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":[],"chunks":[]}