Authentication, spending guardrails, and task data retention for the Databar MCP server
The hosted server at https://mcp.databar.ai/mcp has nothing to install or configure. Databar manages its defaults, and every client gets the same behavior.
OAuth (recommended): add the server URL in your client (Claude Connectors, Cursor, or any remote MCP client) and approve access to your workspace when prompted.
API key: send Authorization: Bearer your-api-key-here with every request. Find your key in your Databar workspace under Integrations.
Tools that spend credits (enrichments, waterfalls, table enrichments, flows) check the cost before anything is queued:
Balance check: if your balance cannot cover even the cheapest step, the tool returns an error with balance_credits and required_credits instead of queueing a run that would fail.
Confirmation above 50 credits: when a run’s estimated ceiling is at least 50 credits, the tool returns status: confirmation_required with estimated_credits. Your agent shows the estimate, and after you agree it re-calls the tool with the retry_with object from that response.
Task data is stored for 24 hours after completion. If you need the results later, make sure to retrieve them promptly. After 24 hours, task data is permanently deleted and the status will return gone.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Databar Docs","colors":{"primary":"#6C5CE7","light":"#A29BFE","dark":"#5A4BD1"},"logo":{"light":"https://mintcdn.com/databar/kfr17W_tEfbrs1P4/logo/light.svg?fit=max\u0026auto=format\u0026n=kfr17W_tEfbrs1P4\u0026q=85\u0026s=38c5d5f2f9c35e46668722b2401d0cc8","dark":"https://mintcdn.com/databar/kfr17W_tEfbrs1P4/logo/dark.svg?fit=max\u0026auto=format\u0026n=kfr17W_tEfbrs1P4\u0026q=85\u0026s=b7015cfb3c09945ab840af1700aa7a49"},"favicon":{"light":"https://mintcdn.com/databar/QEpagu1P8NAlDFi0/favicon.svg?fit=max\u0026auto=format\u0026n=QEpagu1P8NAlDFi0\u0026q=85\u0026s=3ae622ccad8727568a8220e4ffd52805","dark":"https://mintcdn.com/databar/QEpagu1P8NAlDFi0/favicon-dark.svg?fit=max\u0026auto=format\u0026n=QEpagu1P8NAlDFi0\u0026q=85\u0026s=f524b7b27a8f663d25009c2d9fdcc6f6"},"appearance":{"default":"system"},"background":{"decoration":"windows"},"navbar":{"links":[{"href":"mailto:info@databar.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://databar.ai/tables"}},"footer":{"socials":{"x":"https://x.com/databar_ai","linkedin":"https://linkedin.com/company/databar-ai","youtube":"https://www.youtube.com/@databar_ai"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Databar.ai","icon":"globe","href":"https://databar.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"databar","hasAudioNarration":false,"actualSubdomain":"databar","customDomains":["docs.databar.ai"],"gitSource":{"type":"github","owner":"databar-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4bf20f29cac1d3d63acbd","collectionId":"f3a7cae7-c534-4957-a3df-fe84bc942edf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4bf20f29cac1d3d63acbd"},"entitlements":{},"buildId":"6ae4bf20f29cac1d3d63acbd","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"API Reference","count":85},{"language":"default","tag":"Tables","count":42},{"language":"default","tag":"Product Guide","count":34},{"language":"default","tag":"Headless","count":27},{"language":"default","tag":"Core concepts","count":23},{"language":"default","tag":"Flows","count":14},{"language":"default","tag":"Workspace","count":13},{"language":"default","tag":"Enrichments","count":13},{"language":"default","tag":"Workbooks","count":11},{"language":"default","tag":"MCP Server","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"[class*=\"CardGroup\"] img,[class*=\"card-group\"] img{aspect-ratio:16 / 10;object-fit:contain;width:100%;border-radius:12px 12px 0 0;padding:24px;background-color:#fafafa;background-image:linear-gradient(rgba(108, 92, 231, 0.06) 1px, transparent 1px),\n linear-gradient(90deg, rgba(108, 92, 231, 0.06) 1px, transparent 1px);background-size:20px 20px;border:1px solid rgba(108, 92, 231, 0.08)}.dark img[src*=\"mcp.svg\"],.dark img[src*=\"icon-chrome.svg\"],.dark img[src*=\"icon-n8n.svg\"]{filter:brightness(0) invert(1)}[class*=\"Card\"] a,.card a{transition:transform 300ms cubic-bezier(0, 0, 0.2, 1),\n box-shadow 300ms ease}[class*=\"Card\"] a:hover,.card a:hover{transform:translateY(-4px);box-shadow:0 8px 24px rgba(0, 0, 0, 0.08)}"}],"page":{"pagePath":"mcp-configuration","slug":"/mcp-configuration","pageMetadata":{"title":"Configuration","description":"Authentication, spending guardrails, and task data retention for the Databar MCP server","href":"/mcp-configuration"},"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: \"Authentication, spending guardrails, and task data retention for the Databar MCP server\"\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`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The hosted server at `,_jsx(_components.code,{children:`https://mcp.databar.ai/mcp`}),` has nothing to install or configure. Databar manages its defaults, and every client gets the same behavior.`]}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OAuth`}),` (recommended): add the server URL in your client (Claude Connectors, Cursor, or any remote MCP client) and approve access to your workspace when prompted.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API key`}),`: send `,_jsx(_components.code,{children:`Authorization: Bearer your-api-key-here`}),` with every request. Find your key in your `,_jsx(_components.a,{href:`https://databar.ai`,children:`Databar workspace`}),` under `,_jsx(_components.strong,{children:`Integrations`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`spending-guardrails`,children:`Spending guardrails`}),`\n`,_jsx(_components.p,{children:`Tools that spend credits (enrichments, waterfalls, table enrichments, flows) check the cost before anything is queued:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Balance check`}),`: if your balance cannot cover even the cheapest step, the tool returns an error with `,_jsx(_components.code,{children:`balance_credits`}),` and `,_jsx(_components.code,{children:`required_credits`}),` instead of queueing a run that would fail.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Confirmation above 50 credits`}),`: when a run’s estimated ceiling is at least 50 credits, the tool returns `,_jsx(_components.code,{children:`status: confirmation_required`}),` with `,_jsx(_components.code,{children:`estimated_credits`}),`. Your agent shows the estimate, and after you agree it re-calls the tool with the `,_jsx(_components.code,{children:`retry_with`}),` object from that response.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`task-data-retention`,children:`Task data retention`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Task data is stored for `,_jsx(_components.strong,{children:`24 hours`}),` after completion. If you need the results later, make sure to retrieve them promptly. After 24 hours, task data is permanently deleted and the status will return `,_jsx(_components.code,{children:`gone`}),`.`]})})]})}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":"Configuration","description":"Authentication, spending guardrails, and task data retention for the Databar MCP server","href":"/mcp-configuration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Spending guardrails","slug":"spending-guardrails","depth":2,"children":[]},{"title":"Task data retention","slug":"task-data-retention","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"databar","siteName":"Databar Docs","title":"Configuration - Databar Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T09:58:47.901Z","originalFileLocation":"mcp-configuration.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=\"Authentication, spending guardrails, and task data retention for the Databar MCP server\">\u003cmeta data-mint-head name=\"application-name\" content=\"Databar Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configuration - Databar Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Authentication, spending guardrails, and task data retention for the Databar MCP server\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Databar Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.databar.ai/mcp-configuration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://databar.mintlify.app/_mintlify/api/og/v2?division=Reference\u0026amp;title=Configuration\u0026amp;description=Authentication%2C+spending+guardrails%2C+and+task+data+retention+for+the+Databar+MCP+server\u0026amp;theme=2468acd354f0bec92c22e75f\u0026amp;signature=aeff7c1c3badef27e78a754f1b7279270ea0a941c50bb4d3d4ad92446e5839b7\">\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=\"Configuration - Databar Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Authentication, spending guardrails, and task data retention for the Databar MCP server\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://databar.mintlify.app/_mintlify/api/og/v2?division=Reference\u0026amp;title=Configuration\u0026amp;description=Authentication%2C+spending+guardrails%2C+and+task+data+retention+for+the+Databar+MCP+server\u0026amp;theme=2468acd354f0bec92c22e75f\u0026amp;signature=aeff7c1c3badef27e78a754f1b7279270ea0a941c50bb4d3d4ad92446e5839b7\">\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/databar/UayxQWR1b87G5-jl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Databar Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C5CE7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.databar.ai/mcp-configuration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/mcp-configuration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.databar.ai/#organization\",\"name\":\"Databar Docs\",\"url\":\"https://docs.databar.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/databar/kfr17W_tEfbrs1P4/logo/light.svg?fit=max\u0026auto=format\u0026n=kfr17W_tEfbrs1P4\u0026q=85\u0026s=38c5d5f2f9c35e46668722b2401d0cc8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.databar.ai#website\",\"name\":\"Databar Docs\",\"url\":\"https://docs.databar.ai\",\"publisher\":{\"@id\":\"https://docs.databar.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.databar.ai/mcp-configuration#webpage\",\"url\":\"https://docs.databar.ai/mcp-configuration\",\"name\":\"Configuration\",\"description\":\"Authentication, spending guardrails, and task data retention for the Databar MCP server\",\"dateModified\":\"2026-10-05T09:58:47.901Z\",\"isPartOf\":{\"@id\":\"https://docs.databar.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.databar.ai/mcp-configuration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.databar.ai/mcp-configuration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.databar.ai/mcp-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configuration\",\"item\":\"https://docs.databar.ai/mcp-configuration\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.databar.ai/mcp-configuration#article\",\"headline\":\"Configuration\",\"name\":\"Configuration\",\"description\":\"Authentication, spending guardrails, and task data retention for the Databar MCP server\",\"url\":\"https://docs.databar.ai/mcp-configuration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.databar.ai/mcp-configuration#webpage\"},\"dateModified\":\"2026-10-05T09:58:47.901Z\",\"publisher\":{\"@id\":\"https://docs.databar.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.databar.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Databar Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Databar Docs","nav":{"global":{"anchors":[{"anchor":"Databar.ai","icon":"globe","href":"https://databar.ai"}]},"tabs":[{"tab":"Product Guide","icon":"book-open","pages":[{"title":"Product Guide","href":"/product-guide/what-is-databar"}]},{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/developer-guides"}]},{"tab":"MCP Server","icon":"https://mintlify.s3.us-west-1.amazonaws.com/databar/logo/mcp.svg","groups":[{"group":"Overview","icon":"circle-info","pages":[{"title":"MCP Server","href":"/mcp-server"}]},{"group":"Reference","icon":"book-open-reader","pages":[{"title":"Available Tools","description":"Complete list of MCP tools exposed by the Databar MCP server","href":"/mcp-tools"},{"title":"Configuration","href":"/mcp-configuration"}]},{"group":"Agent Skills","icon":"graduation-cap","pages":[{"title":"Agent Skills","description":"Pre-built workflow skills that teach AI agents how to use Databar","href":"/mcp-skills"},{"title":"Single Enrichment","href":"/mcp-skill-enrichment"},{"title":"Table-Driven Enrichment","href":"/mcp-skill-table"},{"title":"Waterfall Enrichment","href":"/mcp-skill-waterfall"},{"title":"Bulk Enrichment","href":"/mcp-skill-bulk"}]}]}]},"basePath":"","title":"Configuration - Databar Docs","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":[],"chunks":[]}