MCP — the Model Context Protocol — is a standard way for AI models to interact with services outside of themselves, like your Xano database. Each individual action you expose to a model is called a tool.Xano’s MCP Builder lets you build those tools exactly the way you build any other function stack, and expose them to any client that supports MCP — Claude, Cursor, ChatGPT, or one you build yourself.
Instead of being limited to REST APIs designed for web and mobile apps, you can build AI-native functionality: function stacks meant to be called by an AI model in response to a request like “Check the user table for any admins that haven’t logged in since the first of the month, and send them a reminder about our activity policies.”That means you can create tools for your AI to:
Retrieve specific data from your Xano database based on natural language queries
Perform complex data manipulations and calculations triggered by AI insights
Write data back to your Xano database based on AI-driven decisions or user requests interpreted by the AI
Interact with external APIs and services through your Xano function stacks, orchestrated by the AI
Interact with the APIs and services you’ve already built in Xano
Not building for MCP specifically, and just want a chatbot or a connection to a model like ChatGPT? See Chatbots instead.
Servers you build in Xano speak Streamable HTTP, the transport the official MCP SDK has standardized on — that’s the connection URL to hand your clients, and the one to build against. You can use any function we have today in your MCP servers.Xano MCP servers support the 2026-07-28 MCP specification, and keep serving clients on every earlier version (2024-11-05, 2025-03-26, 2025-06-18 and 2025-11-25) from the same URL. There’s nothing to configure: each client gets every feature its version supports, and existing clients keep working as before.
Clients sign each user in, with Xano or your own identity provider as the authorization server.
The older SSE transport was removed in v2.6. Existing /sse connection URLs no longer work. Switch each client to the streaming URL — it’s under Connect this backend → MCP Server URLs. See the v2.6 release notes for the full notice.This applies only to MCP servers you build and host in Xano. The Xano MCP Server and the Developer MCP are unaffected.
As MCP is an evolving protocol, we aim to continue to expand the functionality as it develops. If you are utilizing MCP in Xano and have any feedback or questions, please reach out to our support team.
To build MCP servers in Xano, we’ll first need to create a server that will house some tools.
1
From the sidebar, click Agents & MCP
2
Click + Add MCP Server to create your first MCP server
3
Fill out the necessary information
Name - Give your server a name that clearly indicates its purpose.
Description - This is an internal field just for you to expand on the
purpose of the MCP server.
Allow Connections - Choose whether or not to allow connections to this MCP server
Add Tag - Tag your MCP servers for easier search throughout your Xano workspace.
MCP Instructions - These instructions are what your clients will look at to understand the purpose of the MCP server. Markdown format is recommended for easy readability for your LLMs and clients. These instructions apply to the server as a whole, and are not used for individual tool instructions.
Tools are essentially individual actions that your MCP server can perform, such as querying a database, adding new records, or calling an external API. You’ll build tools just like you build any other function stack.Most of the time you already have the logic — an API endpoint or a function stack you built for your app. Exposing one of those as a tool is a couple of clicks and leaves you with one stack to maintain, so start there. Build a tool from scratch when there’s nothing to reuse.
An MCP server can offer three kinds of things. Each one is its own workspace object that you build once and attach to one or more servers. The server page has a tab for each, and the Connect menu attaches them: Connect Tool, Connect Prompt or Connect Resource.
Tool
A tool is an action that your MCP server can perform. Each tool has its own set of logic that defines its behavior, such as querying a database, adding new records, or calling an external API. Usually that logic is an API endpoint or a function stack you already built — you expose it as a tool rather than rewriting it.
Prompt
A prompt is a reusable message template with arguments, which a user picks from their client, such as “Summarize this order.”
Resource
Resources share data that gives language models context, such as files, records, or generated content. Each resource is identified by a URI, which can be a template like orders://{order_id}.
To change how an attached tool behaves on one server, click the ⋮ icon next to it and select Connection Settings. There you can turn the tool on or off with Allow Connections, set its Authentication, and add Tool Meta. These settings apply only to that server.
Resources used to be a Tool Type you set in Connection Settings. Those legacy resource tools still work, but new resources should be resource objects.
In the existing function stack, click the ⋮ settings icon in the upper-right corner and click Use As AI Tool
2
Choose the MCP Server you'd like to add the tool to, and give it a name. This name is what the command will be, so make sure it's understandable
3
Navigate to your MCP Server and check for the newly created tool
Xano will not make a copy of your existing function stack; instead, it will use a Run Endpoint function and call that API internally. This is ideal so you only have to maintain one function stack.
A tool created from an existing API endpoint
4
Adjust the settings for your newly created tool and add instructions
Instructions are important to have so the AI models and clients interacting with this tool understand how to use it.
Give your tool a recognizable name. This is also the command that will be used to execute your tool.
Description
This is an internal-only field just for you to describe the purpose of the tool.
Allow Connections
Enable or disable connection to this specific tool
Add Tag
Tag your tools for easier search across your Xano workspace
Authentication
Determine if this tool requires an authentication token
Tool Instructions
These instructions are what your clients will use to understand how to send requests to the tool, and what the expected result will be. Markdown format is recommended.
3
Build your tool's function stack
If you haven’t already, make sure you’re familiar with Xano’s visual builder.We also have some specific functions that may be useful to you when building tools that allow you to interact with existing function stacks.MCP Functions
Beyond its name and instructions, a tool can tell clients how to display it and what it returns. Open the tool, then ⋮ → Settings. Title sits under the name, and the rest is in the MCP section. All of it is optional, and a tool sends only what you set.
Setting
What it does
Title
A human-friendly display name clients may show instead of the tool’s name, such as “Look Up an Order” for lookup_order.
Annotations
Hints about the tool’s behavior. Each is Not set, Yes or No. Clients treat them as untrusted hints, and Xano doesn’t enforce them.
Icons
Images clients may display next to the tool.
Output Schema
The shape of the tool’s result. With one, the tool returns structured output.
The four annotations are:
Annotation
Means
Read Only
The tool doesn’t modify its environment.
Destructive
The tool may perform destructive updates. Only meaningful when it isn’t read only.
Idempotent
Calling the tool repeatedly with the same arguments has no additional effect. Only meaningful when it isn’t read only.
Open World
The tool may interact with an open world of external entities, such as the web.
Each icon has a source, plus an optional MIME type, sizes (48x48, or any) and theme (light or dark). The source must be an https URL or a base64 data: URI of a PNG, JPEG or WebP image of at most 64 KiB. Click Upload Image to save an image to your workspace Files and fill in the icon for you. SVG and http URLs aren’t accepted.Prompts and resources take a Title and Icons in the same way.In XanoScript, these are fields on the tool:
ai/tool/lookup_order.xs
tool lookup_order { title = "Look up an order" annotations = { read_only_hint : true destructive_hint: false idempotent_hint : true open_world_hint : false } icons = [ { src : "https://cdn.example.com/icons/order.webp" sizes: ["any"] theme: "light" } ] input { int order_id } stack { db.get order { field_name = "id" field_value = $input.order_id } as $order } response = $order output { int id enum status { values = ["open", "closed"] } }}
A tool’s result reaches the client in one of two ways, depending on whether it has an output schema.
Without an output schema, the tool returns its result as text, exactly as before. Strings are sent as they are, and anything else as JSON.
With an output schema, Xano validates the result against the schema and returns it as structuredContent, alongside the same JSON as text for clients that don’t read structured content. The tool also advertises the schema as its outputSchema, so clients know the shape in advance.
The result must be an object, every required field must be there, and types and enum values must match. Extra fields are allowed. If the result doesn’t match, the client gets an error result naming the problem, such as Tool output does not match its output schema: items[0].name: expected a string, got int.A tool with an output schema can also return a full MCP tool result that it builds itself, with content, structuredContent, isError and _meta. Xano passes it through, after validating its structuredContent.
MCP Apps in Claude read structuredContent, so give a tool an output schema to send its data to an MCP App’s interface. Existing tools without one keep returning the same text results.
Building an app to run right inside of ChatGPT? Serve its interface as a resource — see Build apps in ChatGPT with Xano. The video predates resource objects and uses the legacy Resource tool type, but the approach is the same.
Set a tool’s Authentication on, and Xano validates the token the same way it does for the secure APIs you’re already building. You paste that token into your client’s config and it rides along with every request.This is the quick path, and it’s all most header-capable clients need — Claude Code, Cursor, VS Code, Windsurf, Antigravity, Raycast, Warp, Gemini CLI, Codex CLI. See Connecting Clients for the per-client setup.
A header token is shared, not per-user. Every client configured with it sends the same credential, so Xano sees one identity no matter who is asking. $auth can’t tell your users apart, tools can’t scope data to the caller, and revoking access for one person means rotating the token for everyone.That’s a reasonable gate for you and your team on your own machines. It stops being one the moment you ship an MCP server to people who should each see only their own data.
OAuth sign-in, for per-user identity and OAuth-only clients
Turn on Sign-in (OAuth) in the server’s settings, and clients sign each user in before they connect. Every request then arrives as the person who made it, and $auth scopes data per user natively. There are two modes:
Hosted: Xano is the authorization server, and your own login page signs the user in.
External: your identity provider, such as Auth0, WorkOS, Clerk, Microsoft Entra ID, Okta or Amazon Cognito, signs the user in, and Xano verifies its JWT access tokens.
You need this when:
Your client can’t send a header at all. Claude Web, Claude mobile, Claude Desktop’s Add custom connector dialog, ChatGPT developer mode, and Microsoft 365 Copilot are OAuth-only.
You need per-user identity — on any client, including the header-capable ones.
A token in the connection URL isn’t a third option. The MCP spec has prohibited access tokens in the URI query string since its 2025-06-18 revision, and the Claude surfaces run an OAuth handshake for every custom connector — so a URL token sends you to a consent page that can’t complete.
Once sign-in is on, the whole server requires it, and session tokens sent in a header are refused.
Require sign-in (OAuth)
Turn on hosted or external sign-in, build the login handoff, and set up your identity provider.
Bring your own identity provider
Run your own OAuth front end with a Cloudflare Worker, for setups built-in sign-in doesn’t cover.
Each server’s connection URL is under Connection URL on its card in the MCP Servers list, and Copy Connection URL on the server’s page.The URL follows the branch you’re working on. On a non-live branch, the branch name is added to the server’s canonical after a colon, so you can connect a client to a branch and test it before you make it live. A URL without a branch always reaches the live branch.
Clients on the 2026-07-28 specification can listen for changes to a server. When you add, remove or edit an attached tool, prompt or resource in a way the client would see, such as its name, title, description, inputs or icons, connected clients are told to re-list. Edits to a stack alone don’t trigger a notification. There’s nothing to build: Xano sends them automatically.
You can pass URL parameters as part of your connection URL, such as ?beta=true, and read them in your tool function stacks as the params variable to change how the tools behave.
Now that you’ve built an MCP server and added some tools to it, you can connect with your client of choice. Choose from the list below for a quick getting started guide.If you’re new to MCP servers, we recommend starting with Cursor.
Try to find a balance when writing instructions between being clear and descriptive, but also concise. Reducing the amount of tokens sent to an AI model will reduce token cost, improve speed, and improve responses.
Use error handling with clear error messages. If an AI model fails to use a tool, clear error messages will allow it to retry the tool successfully.
Standardization: MCP provides a common way for different applications and LLMs to interact, reducing the need for custom integrations.
Interoperability: MCP enables different LLMs and applications to work together more easily.
Flexibility: MCP allows developers to connect LLMs to a wide range of external resources.
Efficiency: MCP streamlines the process of building AI agents and applications.
Is MCP tied to a specific LLM or platform?
No, MCP is designed to be an open and vendor-neutral protocol, allowing it to be used with various LLMs and platforms.
How does MCP relate to APIs?
While APIs provide access to specific functions, MCP provides a standardized way for LLMs to discover and use those functions in a context-aware manner.
What is the role of “context” in MCP?
Context is crucial in MCP. It provides the LLM with the necessary information about the user’s request, the available tools, and the overall environment, enabling the LLM to make more informed decisions.
How is security handled in MCP?
MCP emphasizes secure communication between clients and servers. Mechanisms like authentication, authorization, and secure data transfer are important considerations in MCP implementations.
Can I build multiple MCP servers?
Yes, in Xano you can build multiple MCP servers and they can all have their own tools available.
Was this page helpful?
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Xano Documentation","colors":{"primary":"#1b62f8","light":"#3884ff","dark":"#1b62f8"},"logo":{"light":"https://mintcdn.com/xano-997cb9ee/hLg--ImSu58u2jLW/logo/logo_wordmark_blue_1_.svg?fit=max\u0026auto=format\u0026n=hLg--ImSu58u2jLW\u0026q=85\u0026s=487b8933249723b2ebc7bf7b6179ea0c","dark":"https://mintcdn.com/xano-997cb9ee/hLg--ImSu58u2jLW/logo/logo_wordmark_white.svg?fit=max\u0026auto=format\u0026n=hLg--ImSu58u2jLW\u0026q=85\u0026s=2d791d4d44350552266e449b7bea065c"},"favicon":"https://mintcdn.com/xano-997cb9ee/hLg--ImSu58u2jLW/logo/logo_symbol_blue.svg?fit=max\u0026auto=format\u0026n=hLg--ImSu58u2jLW\u0026q=85\u0026s=5d31c3241d161111c202c2ec3afcbcc0","background":{"color":{"light":"#f9f9f9","dark":"#141518"}},"navbar":{"links":[{"href":"/legal","label":"Legal"},{"href":"/updates","label":"Releases"},{"href":"https://status.xano.com/","label":"Status"},{"href":"https://app.xano.com/","label":"Log in"}],"primary":{"type":"button","label":"Get started for free","href":"https://app.xano.com/signup?plan=build\u0026cluster_id=1\u0026segment=eyJhbm9ueW1vdXNJZCI6IjU4NTcwNzY4NDUuODY1MzMwMTE5MCIsInV0bV9tZWRpdW0iOiIiLCJ1dG1fc291cmNlIjoiIiwidXRtX2NhbXBhaWduIjoiIiwidXRtX3Rlcm0iOiIiLCJ1dG1fY29udGVudCI6IiIsInJlZmVycmVyIjoiIn0%3D"}},"footer":{"socials":{"x":"https://x.com/nocodebackend","youtube":"https://www.youtube.com/@nocodebackend","linkedin":"https://www.linkedin.com/company/xano","facebook":"https://www.facebook.com/xanoinc"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Xano Documentation","og:description":"Visual-first unified backend for modern apps. Build APIs, AI Agents, data, logic, auth, \u0026 more—all in one platform."},"indexing":"all"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"intercom":{"appId":"abk6h5qu"},"segment":{"key":"manKNsFY6zkgO9hggr91nc5yFYUh2d4B"}},"errors":{"404":{"redirect":false,"title":"Looks like a wire came loose","description":"The page you're looking for doesn't exist, or it moved. Try the search bar above, browse the [documentation home](/), or [contact support](https://xano.com/contact/) if you think something's broken."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xano-997cb9ee","hasAudioNarration":false,"actualSubdomain":"xano-997cb9ee","customDomains":["docs.xano.com"],"gitSource":{"type":"github","owner":"xano-labs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af389f8852f6902678b3f65","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Metadata API","count":208},{"language":"default","tag":"Xano","count":132},{"language":"default","tag":"Build","count":47},{"language":"default","tag":"XanoScript","count":46},{"language":"default","tag":"References","count":32},{"language":"default","tag":"table / schema / type","count":25},{"language":"default","tag":"Test \u0026 Deploy","count":20},{"language":"default","tag":"CLI","count":18},{"language":"default","tag":"Enterprise","count":17},{"language":"default","tag":"Logic \u0026 Workflows","count":13}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#content-area .link{color:#103B95}.prose img:not([data-rmiz-modal-img]){max-width:60%;height:auto}.w-full aspect-video rounded-xl{max-width:60%!important}[data-rmiz-modal-content] img[data-rmiz-modal-img]{max-width:90vw!important;max-height:90vh!important;object-fit:contain}html.dark #content-area .link{color:#6B99FA}html.dark .mermaid svg g.node .label text,html.dark .mermaid svg g.node span.nodeLabel{fill:#eaf1ff!important;color:#103B95!important}html.dark .mermaid svg g.node rect,html.dark .mermaid svg g.node circle,html.dark .mermaid svg g.node ellipse,html.dark .mermaid svg g.node polygon,html.dark .mermaid svg g.node path{stroke:#8fb3ff!important;stroke-width:15px!important}img{background:none!important;background-color:transparent!important}.nodeLabel{font-size:12px}.stickyDiagram{position:sticky;top:var(--scroll-mt);flex:0 0 180px;min-width:100px}@media (max-width: 768px){.stickyDiagram{position:static;top:auto;flex:none;width:100%;margin-bottom:1rem}}table{display:table!important;width:100%;table-layout:auto}table th,table td{vertical-align:top;border-left:1px solid #dadada!important;border-right:1px solid #dadada!important;padding:0.5rem!important}.table-wrapper{overflow-x:visible}.supportButton{border:0px!important}.arcadediv{position:relative;padding-bottom:calc(80.4861% + 41px);height:0px;width:100%}.arcadeiframe{position:absolute;top:0;left:0;width:100%;height:100%!important;color-scheme:light}.tab-icon{display:inline-block;border-radius:4px;padding:2px}html.dark .tab-icon{background-color:#bababa!important}h2>span>.icon{position:relative;top:-0.1em;margin-right:0.4rem;vertical-align:middle}.ui-bubble{display:inline-flex;align-items:center;gap:0.35rem;padding:0.2rem 0.5rem;margin-bottom:0.2rem;margin-left:0.2rem;margin-right:0.2rem;background-color:var(--mintlify-code-bg, #f3f4f6);border:1px solid var(--mintlify-border-color, #e5e7eb);border-radius:6px;font:inherit;vertical-align:middle;font-size:0.9em!important;font-weight:800!important}html.dark .ui-bubble{background-color:#1f2937;border-color:#374151}.ui-bubble .icon{width:1.2em!important;height:1.2em!important;flex-shrink:0;display:inline-block;vertical-align:middle}.kb{display:inline-flex;align-items:center;gap:0.35rem;padding:0.2rem 0.5rem;margin-bottom:0.2rem;margin-left:0.2rem;margin-right:0.2rem;background-color:var(--mintlify-code-bg, #f3f4f6);border:1px solid var(--mintlify-border-color, #e5e7eb);border-radius:6px;font:inherit;vertical-align:middle;font-size:0.8em!important;font-weight:600!important;font-family:ui-monospace, \"SFMono-Regular\", \"Fira Code\",\n \"Cascadia Code\", Menlo, Consolas, monospace!important}html.dark .kb{background-color:#1f2937;border-color:#374151}.kb .icon{width:1em!important;height:1em!important;flex-shrink:0;display:inline-block;vertical-align:middle}.kbd{display:inline-flex;align-items:center;gap:0.3rem;padding:0.15rem 0.45rem;margin-bottom:0.2rem;margin-left:0.2rem;margin-right:0.2rem;background-color:var(--mintlify-code-bg, #f3f4f6);border:1px solid var(--mintlify-border-color, #e5e7eb);border-bottom-width:3px;border-radius:6px;font:inherit;vertical-align:middle;font-size:0.85em!important;font-weight:700!important;line-height:1.4;white-space:nowrap;user-select:none;color:var(--mintlify-content-color, #374151)}html.dark .kbd{background-color:#1f2937;border-color:#374151;border-bottom-color:#4b5563;color:#e5e7eb}.kbd .icon{width:1.1em!important;height:1.1em!important;flex-shrink:0;display:inline-block;vertical-align:middle}.kbd svg{width:1em;height:1em;flex-shrink:0;vertical-align:middle}.kbd--mac::before{font-family:\"Font Awesome 6 Brands\", \"Font Awesome 6 Free\", FontAwesome;content:\"\\f179\";font-weight:900;font-style:normal;font-size:0.95em;margin-right:0.25em;vertical-align:middle}.kbd--windows::before{font-family:\"Font Awesome 6 Brands\", \"Font Awesome 6 Free\", FontAwesome;content:\"\\f17a\";font-weight:400;font-style:normal;font-size:0.9em;margin-right:0.25em;vertical-align:middle}.kbd--linux::before{font-family:\"Font Awesome 6 Brands\", \"Font Awesome 6 Free\", FontAwesome;content:\"\\f17c\";font-weight:400;font-style:normal;font-size:0.95em;margin-right:0.25em;vertical-align:middle}:root[data-theme=\"dark\"] .prose :where(h1,h2,h3,h4,h5,h6),html.dark .prose :where(h1,h2,h3,h4,h5,h6){color:#fff!important}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0!important;margin-bottom:0!important}.prose :where(h1,h2,h3,h4,h5,h6)[id]{scroll-margin-top:120px!important}.browser-frame{--bf-radius: 10px;--bf-shadow: 0 8px 24px rgba(0,0,0,.06);--bf-border: #e5e7eb;--bf-bg: #ffffff;--bf-chrome: #f3f4f6;--bf-text: #6b7280;--bf-address-bg: rgba(255,255,255,.75);border:1px solid var(--bf-border);border-radius:var(--bf-radius);background:var(--bf-bg);box-shadow:var(--bf-shadow);overflow:hidden;max-width:100%}.dark .browser-frame{--bf-border: rgba(255,255,255,.12);--bf-bg: #0b0f19;--bf-chrome: #111827;--bf-text: rgba(255,255,255,.70);--bf-address-bg: rgba(255,255,255,.06);--bf-shadow: 0 12px 34px rgba(0,0,0,.45)}.browser-frame__top{display:flex;align-items:center;gap:8px;padding:7px 10px;background:var(--bf-chrome);border-bottom:1px solid var(--bf-border)}.browser-frame__controls{display:flex;align-items:center;gap:6px;flex:0 0 auto}.browser-frame__dot{width:10px;height:10px;border-radius:999px;box-shadow:inset 0 0 0 1px rgba(0,0,0,.12)}.dark .browser-frame__dot{box-shadow:inset 0 0 0 1px rgba(255,255,255,.10)}.browser-frame__dot--red{background:#ff5f57}.browser-frame__dot--yellow{background:#febc2e}.browser-frame__dot--green{background:#28c840}.browser-frame__address{flex:1 1 auto;height:22px;border-radius:999px;border:1px solid rgba(0,0,0,.06);background:var(--bf-address-bg);display:flex;align-items:center;justify-content:center;padding:0 10px;font:500 11px/1.2 ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial;color:var(--bf-text);letter-spacing:.2px;user-select:none}.dark .browser-frame__address{border-color:rgba(255,255,255,.08)}.browser-frame__body{background:var(--bf-bg)}.browser-frame__body img{width:100%;height:auto}.browser-frame__body *{border:none!important;border-radius:0!important;box-shadow:none!important;background:transparent!important}.browser-frame__body>*{margin:0!important;padding:0!important}.browser-frame__body pre{margin:0!important;padding:0!important}.browser-frame__body .browser-frame__img--light{display:block}.browser-frame__body .browser-frame__img--dark{display:none}.dark .browser-frame__body .browser-frame__img--light{display:none}.dark .browser-frame__body .browser-frame__img--dark{display:block}.qs-step{border:1px solid var(--mintlify-border-color, #e5e7eb);border-radius:1rem;padding:2rem;margin-bottom:2rem;position:relative}.qs-step-number{position:absolute;top:-0.75rem;left:1.25rem;width:1.75rem;height:1.75rem;border-radius:50%;background:linear-gradient(135deg, #1b62f8, #6366f1);display:flex;align-items:center;justify-content:center;color:#fff;font-size:0.8rem;font-weight:700;line-height:1}.qs-step h3:first-of-type{margin-top:0.25rem}.feature-grid{display:grid;grid-template-columns:1fr 1fr;border:none;margin:0.5rem 0 0.5rem}.feature-grid__item{padding:1.25rem 1.5rem;text-align:justify}.feature-grid__item strong{font-size:1.15rem}.feature-grid__item svg{margin-right:0.4rem;width:1.75em;height:1.75em;vertical-align:middle;position:relative;top:-0.1em}.feature-grid__desc{margin-top:0.75rem}.feature-grid__item:nth-child(odd){border-right:1px solid var(--mintlify-border-color, #e5e7eb)}.feature-grid__item:nth-child(n+3){border-top:1px solid var(--mintlify-border-color, #e5e7eb)}html.dark .feature-grid__item:nth-child(odd){border-right-color:rgba(255, 255, 255, 0.1)}html.dark .feature-grid__item:nth-child(n+3){border-top-color:rgba(255, 255, 255, 0.1)}@media (max-width: 640px){.feature-grid{grid-template-columns:1fr}.feature-grid__item:nth-child(odd){border-right:none}.feature-grid__item:nth-child(n+2){border-top:1px solid var(--mintlify-border-color, #e5e7eb)}}html.dark .callout[data-callout-type=\"tip\"]{background-color:rgba(5, 46, 22, 0.6)!important}.hero-tabs [role=\"tablist\"]{display:flex!important;gap:0.75rem;border-bottom:none!important;margin-bottom:1.5rem}.hero-tabs [role=\"tab\"]{flex:1;text-align:center;padding:0.625rem 1rem;border:1px solid var(--mintlify-border-color, #e5e7eb);border-radius:0.75rem;font-weight:500;font-size:0.9rem;color:#374151;background:var(--mintlify-card-bg, #fff);cursor:pointer;transition:all 0.15s ease;box-shadow:0 1px 2px rgba(0, 0, 0, 0.04)}html.dark .hero-tabs [role=\"tab\"]{color:#d1d5db;background:var(--mintlify-card-bg, rgba(255, 255, 255, 0.05));border-color:var(--mintlify-border-color, rgba(255, 255, 255, 0.1));box-shadow:0 1px 2px rgba(0, 0, 0, 0.2)}.hero-tabs [role=\"tab\"]:hover{border-color:#1b62f8;color:#111827;box-shadow:0 1px 3px rgba(56, 132, 255, 0.15)}html.dark .hero-tabs [role=\"tab\"]:hover{border-color:#3884ff;color:#f3f4f6;box-shadow:0 1px 3px rgba(56, 132, 255, 0.25)}.hero-tabs [role=\"tab\"][aria-selected=\"true\"]{border-color:#1b62f8;color:#103B95;background:#eef4ff;box-shadow:0 1px 3px rgba(56, 132, 255, 0.18)}html.dark .hero-tabs [role=\"tab\"][aria-selected=\"true\"]{border-color:#6B99FA;color:#eaf1ff;background:rgba(56, 132, 255, 0.16);box-shadow:0 1px 3px rgba(0, 0, 0, 0.3)}.hero-tabs [role=\"tab\"],.hero-tabs [role=\"tab\"] *{text-decoration:none!important}.hero-tabs [role=\"tab\"] *{border-bottom:none!important}@media (min-width: 1024px){#content-area{max-width:1100px!important}}@media (min-width: 1280px){#content-area{margin-left:auto!important;margin-right:auto!important}}@media (min-width: 1800px){#content-area{max-width:1200px!important}}.opsai-hero{position:relative;display:flex;flex-direction:column;align-items:center;margin:0 0 2.5rem;padding:3.25rem 2rem 3rem;border-radius:1.25rem;overflow:hidden;text-align:center;background:radial-gradient(120% 140% at 50% -20%, rgba(56, 132, 255, 0.35) 0%, rgba(56, 132, 255, 0) 60%),\n linear-gradient(160deg, #0b1220 0%, #0e1729 55%, #0b1220 100%);border:1px solid rgba(56, 132, 255, 0.25)}.opsai-hero::after{content:\"\";position:absolute;inset:0;background-image:linear-gradient(rgba(56, 132, 255, 0.06) 1px, transparent 1px),\n linear-gradient(90deg, rgba(56, 132, 255, 0.06) 1px, transparent 1px);background-size:36px 36px;-webkit-mask-image:radial-gradient(70% 70% at 50% 0%, #000 0%, transparent 75%);mask-image:radial-gradient(70% 70% at 50% 0%, #000 0%, transparent 75%);pointer-events:none}.opsai-hero>*{position:relative;z-index:1}.opsai-mark{display:flex;align-items:center;justify-content:center;width:72px;height:72px;margin:0 0 1rem;border-radius:50%;background:rgba(56, 132, 255, 0.12);box-shadow:0 0 0 8px rgba(56, 132, 255, 0.06);animation:opsai-glow 4.5s ease-in-out infinite}.opsai-mark::before{content:\"\";width:34px;height:34px;background-repeat:no-repeat;background-position:center;background-size:contain;background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%237db4ff' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='3'/%3E%3Cpath d='M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42'/%3E%3C/svg%3E\")}@keyframes opsai-glow{0%,100%{box-shadow:0 0 0 8px rgba(56, 132, 255, 0.06)}50%{box-shadow:0 0 0 13px rgba(56, 132, 255, 0.03)}}@media (prefers-reduced-motion: reduce){.opsai-mark{animation:none}}.opsai-wordmark{display:flex;justify-content:center;align-items:baseline;width:100%;font-size:3rem!important;font-weight:800!important;letter-spacing:-0.04em;line-height:1!important;margin:0!important;padding:0!important;border:0!important;color:#f8fafc!important}.opsai-wordmark .accent{background:linear-gradient(90deg, #1b62f8, #7db4ff);-webkit-background-clip:text;background-clip:text;color:transparent}.opsai-tagline{margin:1.15rem 0 0!important;max-width:40rem;font-size:1.15rem;line-height:1.55;color:#cbd5e1!important}.opsai-tagline strong{color:#f1f5f9;font-weight:700}.opsai-pills{display:flex;flex-wrap:wrap;gap:0.5rem;justify-content:center;margin-top:1.5rem}.opsai-pill{font-size:0.8rem;font-weight:600;letter-spacing:0.01em;color:#bfdbfe;padding:0.35rem 0.85rem;border-radius:999px;border:1px solid rgba(56, 132, 255, 0.35);background:rgba(56, 132, 255, 0.10)}.opsai-stats{display:grid;grid-template-columns:repeat(3, 1fr);gap:1rem;margin:0 0 2.5rem}@media (max-width: 720px){.opsai-stats{grid-template-columns:1fr}}.opsai-stat{text-align:center;padding:1.4rem 1rem;border-radius:0.9rem;border:1px solid rgba(148, 163, 184, 0.18);background:linear-gradient(180deg, rgba(56, 132, 255, 0.06), rgba(56, 132, 255, 0.01))}.opsai-stat__num{font-size:1.7rem;font-weight:800;letter-spacing:-0.03em;background:linear-gradient(90deg, #1b62f8, #7db4ff);-webkit-background-clip:text;background-clip:text;color:transparent;line-height:1.1}.opsai-stat__label{margin-top:0.45rem;font-size:0.9rem;color:#94a3b8;line-height:1.45}.opsai-nav{display:flex;gap:1rem;margin-top:3rem}@media (max-width: 600px){.opsai-nav{flex-direction:column}}.opsai-nav a{flex:1 1 0;display:block;padding:1rem 1.15rem;border-radius:0.75rem;border:1px solid rgba(148, 163, 184, 0.22);background:linear-gradient(180deg, rgba(56, 132, 255, 0.05), rgba(56, 132, 255, 0.01));text-decoration:none!important;transition:border-color 0.15s ease, transform 0.15s ease}.opsai-nav a:hover{border-color:rgba(56, 132, 255, 0.5);transform:translateY(-1px)}.opsai-nav a.opsai-nav--next{text-align:right}.opsai-nav__dir{display:block;font-size:0.72rem;font-weight:700;letter-spacing:0.06em;text-transform:uppercase;color:#64748b}.opsai-nav__title{display:block;margin-top:0.25rem;font-size:1.02rem;font-weight:600;color:#1b62f8}div:has(>div>.chat-assistant-input){background-color:#eef4ff!important;border-color:#cbd5e1!important;box-shadow:0 2px 12px rgba(16, 59, 149, 0.14)!important;transition:border-color 0.15s ease, box-shadow 0.15s ease,\n opacity 0.25s ease!important}html.chat-dimmed div:has(>div>.chat-assistant-input){opacity:0.35}html.chat-dimmed div:has(>div>.chat-assistant-input):hover,html.chat-dimmed div:has(>div>.chat-assistant-input):focus-within{opacity:1}@media (prefers-reduced-motion: reduce){div:has(>div>.chat-assistant-input){transition:none!important}}div:has(>div>.chat-assistant-input):hover{border-color:#94a3b8!important}div:has(>div>.chat-assistant-input):focus-within{border-color:#1b62f8!important;box-shadow:0 4px 18px rgba(16, 59, 149, 0.22)!important}html.dark div:has(>div>.chat-assistant-input){background-color:#16203a!important;border-color:rgba(255, 255, 255, 0.3)!important;box-shadow:0 2px 14px rgba(0, 0, 0, 0.45)!important}html.dark div:has(>div>.chat-assistant-input):hover{border-color:rgba(255, 255, 255, 0.5)!important}html.dark div:has(>div>.chat-assistant-input):focus-within{border-color:#6B99FA!important}.chat-assistant-input::placeholder{color:#103B95!important;opacity:1!important;font-weight:600}html.dark .chat-assistant-input::placeholder{color:#9dc0ff!important}.steps [data-component-part=\"step-number\"]>div{border-radius:0.5rem!important;background-color:#f1f5f9!important;border:1px solid #cbd5e1;color:#0f172a!important;box-shadow:0 1px 2px rgba(15, 23, 42, 0.06)}html.dark .steps [data-component-part=\"step-number\"]>div{background-color:#1f2937!important;border-color:rgba(255, 255, 255, 0.18);color:#f3f4f6!important;box-shadow:none}.steps [data-component-part=\"step-line\"]{width:1.5px!important}.steps [data-component-part=\"step-line\"]:not([class*=\"to-transparent\"]){background-color:#cbd5e1!important}.steps [data-component-part=\"step-line\"][class*=\"to-transparent\"]{background-color:transparent!important;background-image:linear-gradient(to bottom, #cbd5e1, rgba(203, 213, 225, 0))!important}html.dark .steps [data-component-part=\"step-line\"]:not([class*=\"to-transparent\"]){background-color:rgba(255, 255, 255, 0.18)!important}html.dark .steps [data-component-part=\"step-line\"][class*=\"to-transparent\"]{background-image:linear-gradient(to bottom, rgba(255, 255, 255, 0.18), rgba(255, 255, 255, 0))!important}.steps [data-component-part=\"step-content\"]:first-child>h3:first-child{margin-top:0;font-size:1em;line-height:1.75;font-weight:600}nav ul.toc{position:relative;padding-left:0.875rem}nav ul.toc li.toc-item>a{position:relative}nav ul.toc li.toc-item>a::after{content:\"\";position:absolute;top:0;bottom:0;left:calc(var(--toc-padding-left, 0rem) - 0.875rem);width:1.5px;background-color:#e5e7eb;transition:background-color 0.2s ease}html.dark nav ul.toc li.toc-item>a::after{background-color:rgba(255, 255, 255, 0.12)}nav ul.toc .toc-slider{position:absolute;top:0;left:0;z-index:1;list-style:none;width:1.5px;height:0;opacity:0;background-color:#1b62f8;transition:transform 0.25s cubic-bezier(0.4, 0, 0.2, 1),\n height 0.25s cubic-bezier(0.4, 0, 0.2, 1), opacity 0.15s ease;pointer-events:none}html.dark nav ul.toc .toc-slider{background-color:#6B99FA}nav ul.toc .toc-link,nav ul.toc .toc-tracer{position:absolute;top:0;left:0;height:1.5px;list-style:none;pointer-events:none}nav ul.toc .toc-link{background-image:repeating-linear-gradient(\n to right,\n #d1d5db 0 2px,\n transparent 2px 5px\n )}html.dark nav ul.toc .toc-link{background-image:repeating-linear-gradient(\n to right,\n rgba(255, 255, 255, 0.22) 0 2px,\n transparent 2px 5px\n )}nav ul.toc .toc-tracer{width:0;opacity:0;z-index:1;background-color:#1b62f8;transition:transform 0.15s cubic-bezier(0.4, 0, 0.2, 1),\n width 0.15s cubic-bezier(0.4, 0, 0.2, 1), opacity 0.15s ease}html.dark nav ul.toc .toc-tracer{background-color:#6B99FA}@media (prefers-reduced-motion: reduce){nav ul.toc .toc-slider,nav ul.toc .toc-tracer{transition:none}}html:not(.toc-slide) nav ul.toc li.toc-item[data-active]>a::after{background-color:#1b62f8}html:not(.toc-slide) nav ul.toc li.toc-item[data-active]:has(li.toc-item[data-active])>a::after,html:not(.toc-slide) nav ul.toc li.toc-item[data-active]:has(~li.toc-item[data-active])>a::after{background-color:#e5e7eb}html.dark:not(.toc-slide) nav ul.toc li.toc-item[data-active]>a::after{background-color:#6B99FA}html.dark:not(.toc-slide) nav ul.toc li.toc-item[data-active]:has(li.toc-item[data-active])>a::after,html.dark:not(.toc-slide) nav ul.toc li.toc-item[data-active]:has(~li.toc-item[data-active])>a::after{background-color:rgba(255, 255, 255, 0.12)}div.border-l:has(ul.toc){border-left:none!important}.chat-assistant-send-button{background-color:#1b62f8!important}.chat-assistant-send-button:hover{background-color:#1f6dea!important}@font-face{font-family:\"Press Start 2P\";font-style:normal;font-weight:400;font-display:swap;src:url(\"/fonts/press-start-2p-latin.woff2\") format(\"woff2\");unicode-range:U+0030-0039}div:has(>#error-badge)::before{content:\"\";display:block;width:100%;max-width:131px;aspect-ratio:262 / 292;margin:0 auto -0.9rem;translate:-5px;z-index:1;background:url(\"/images/robot-not-found.png\") center bottom / contain no-repeat;image-rendering:pixelated}#error-badge{font-family:\"Press Start 2P\", ui-monospace, monospace;font-size:5.5rem;line-height:1;letter-spacing:0;padding:0}.sidebar-group-header .sidebar-title{text-transform:uppercase;font-size:0.6875rem;font-weight:600;letter-spacing:0.06em}#navigation-items div:has(>.sidebar-group-header):not(:first-child){margin-top:2.5rem}#navigation-items button.group>div:has(>svg.transition-transform){margin-left:auto}#navigation-items li ul li a>div:first-child:has(>:is(svg,img)){display:none}.prompt{padding:1.25rem!important;gap:0.875rem!important;border-color:#cfe0ff!important;background:linear-gradient(180deg, #f6faff 0%, #edf4ff 100%)!important;box-shadow:0 1px 2px rgba(16, 59, 149, 0.06)}html.dark .prompt{border-color:rgba(56, 132, 255, 0.28)!important;background:rgba(56, 132, 255, 0.08)!important;box-shadow:none}.prompt [data-component-part=\"prompt-icon\"] svg{background-color:#1b62f8!important}html.dark .prompt [data-component-part=\"prompt-icon\"] svg{background-color:#6b99fa!important}.prompt [data-component-part=\"prompt-description\"]{font-size:0.9375rem;line-height:1.5}.prompt [data-component-part=\"prompt-actions-wrapper\"]{flex-basis:100%;justify-content:flex-end;gap:0.5rem!important}.prompt [data-component-part=\"prompt-action-copy-button\"],.prompt [data-component-part=\"prompt-action-cursor-button\"]{padding:0.4375rem 0.875rem!important;font-size:0.8125rem!important;line-height:1.25rem!important;border-radius:0.625rem!important}.prompt [data-component-part=\"prompt-action-copy-button\"]{background-color:#1b62f8!important;box-shadow:0 1px 2px rgba(16, 59, 149, 0.18)}.prompt [data-component-part=\"prompt-action-copy-button\"]:hover{background-color:#2f6fd9!important}.prompt [data-component-part=\"prompt-action-cursor-button\"]{color:#103b95!important;background:#fff!important;border-color:#cfe0ff!important;box-shadow:0 1px 2px rgba(16, 59, 149, 0.06)}.prompt [data-component-part=\"prompt-action-cursor-button\"]:hover{background:#f3f8ff!important;border-color:#1b62f8!important}html.dark .prompt [data-component-part=\"prompt-action-cursor-button\"]{color:#eaf1ff!important;background:rgba(255, 255, 255, 0.06)!important;border-color:rgba(56, 132, 255, 0.35)!important;box-shadow:none}html.dark .prompt [data-component-part=\"prompt-action-cursor-button\"]:hover{background:rgba(56, 132, 255, 0.18)!important;border-color:#6b99fa!important}@font-face{font-family:\"Kalam\";font-style:normal;font-weight:400;font-display:swap;src:url(\"/fonts/kalam-latin-400.woff2\") format(\"woff2\");unicode-range:U+0000-00FF, U+2018-2019, U+201C-201D, U+2013-2014}.hand-note{position:relative;z-index:5;display:flex;align-items:flex-end;gap:0.25rem;margin:1.5rem 0 0.75rem;color:#1b62f8;pointer-events:none}.hand-note-right{justify-content:flex-end;padding-right:1rem}.hand-note-left{justify-content:flex-start;padding-left:1rem;flex-direction:row-reverse}html.dark .hand-note{color:#6b99fa}.hand-note-text{font-family:\"Kalam\", \"Comic Sans MS\", cursive;font-size:1.125rem;line-height:1.2;transform:rotate(-3deg)}.hand-note-arrow{width:44px;height:66px;margin-bottom:-44px;flex:none}.hand-note-left .hand-note-arrow{transform:scaleX(-1)}:not(pre)>code{color:#18181b!important;background-color:rgba(17, 24, 39, 0.08)!important;border-color:rgba(17, 24, 39, 0.1)!important}html.dark :not(pre)>code{color:#f4f4f5!important;background-color:rgba(255, 255, 255, 0.1)!important;border-color:rgba(255, 255, 255, 0.14)!important}a :not(pre)>code,a>code{color:inherit!important}details.accordion{border-color:rgba(17, 24, 39, 0.08)!important;background:#fff!important}html.dark details.accordion{border-color:rgba(255, 255, 255, 0.12)!important;background:transparent!important}details.accordion>summary{padding:1.0625rem 1.5rem!important}details.accordion>summary:hover{background:#f6f8fb!important}details.accordion>[data-component-part=\"accordion-content\"]{padding-top:0.75rem!important}html.dark details.accordion>summary:hover{background:rgba(255, 255, 255, 0.04)!important}.faqx{--faqx-line:var(--gray-200,#e5e7eb);--faqx-fg:var(--gray-900,#111827);--faqx-fg2:var(--gray-500,#6b7280);--faqx-bg:#fff;--faqx-accent:#3884ff;display:flex;align-items:center;justify-content:flex-end;gap:8px;flex-wrap:wrap;margin-bottom:12px}html.dark .faqx{--faqx-line:rgba(255,255,255,.1);--faqx-fg:var(--gray-100,#f3f4f6);--faqx-fg2:var(--gray-400,#9ca3af);--faqx-bg:transparent}.faqx--inline{margin-top:-2.5rem}@media (max-width:640px){.faqx--inline{margin-top:0;justify-content:flex-start}}.faqx-search{position:relative;flex:0 1 260px;min-width:180px}.faqx-search svg{position:absolute;left:9px;top:50%;transform:translateY(-50%);width:13px;height:13px;color:var(--faqx-fg2);pointer-events:none}.faqx-input{width:100%;box-sizing:border-box;font-size:13px;line-height:1.4;color:var(--faqx-fg);background:var(--faqx-bg);border:1px solid var(--faqx-line);border-radius:8px;padding:6px 10px 6px 27px;outline:none;transition:border-color .15s ease,box-shadow .15s ease}.faqx-input::placeholder{color:var(--faqx-fg2)}.faqx-input:focus{border-color:var(--faqx-accent);box-shadow:0 0 0 3px color-mix(in srgb,var(--faqx-accent) 18%,transparent)}.faqx-input::-webkit-search-cancel-button{cursor:pointer}.faqx-btn{font-size:13px;line-height:1.4;font-weight:500;color:var(--faqx-fg);white-space:nowrap;background:var(--faqx-bg);border:1px solid var(--faqx-line);border-radius:8px;padding:6px 11px;cursor:pointer;transition:border-color .15s ease,color .15s ease}.faqx-btn:hover{border-color:var(--faqx-accent);color:var(--faqx-accent)}.faqx-btn:focus-visible{outline:2px solid var(--faqx-accent);outline-offset:2px}.faqx-count{font-size:12px;color:var(--faqx-fg2);white-space:nowrap}.faqx--hero{flex-wrap:nowrap;gap:10px;margin:0 0 2rem}.faqx--hero .faqx-search{flex:1 1 auto;min-width:0}.faqx--hero .faqx-search svg{left:14px;width:16px;height:16px}.faqx--hero .faqx-input{font-size:15px;padding:11px 84px 11px 40px;border-radius:12px;box-shadow:0 1px 2px rgba(17,24,39,.05)}.faqx--hero .faqx-btn{font-size:14px;padding:11px 16px;border-radius:12px;flex:none}.faqx--hero .faqx-count{position:absolute;right:14px;top:50%;transform:translateY(-50%);pointer-events:none}html.dark .faqx--hero .faqx-input{background:rgba(255,255,255,.03);box-shadow:none}.faqx-empty{font-size:14px;color:var(--faqx-fg2);border:1px dashed var(--faqx-line);border-radius:12px;padding:16px;text-align:center;margin-bottom:12px}.accordion-group>details[data-faqx-hidden]{display:none!important}.accordion-group[data-faqx-hidden],h2[data-faqx-hidden],h3[data-faqx-hidden]{display:none!important}.accordion-group>details[data-faqx-first]{border-top-width:0!important}::highlight(faqx-hit){background:color-mix(in srgb,#3884ff 22%,transparent);color:inherit;border-radius:2px}html.dark ::highlight(faqx-hit){background:color-mix(in srgb,#3884ff 38%,transparent)}@media (prefers-reduced-motion:reduce){.faqx-input,.faqx-btn{transition:none}}.faqx-count[hidden],.faqx-empty[hidden]{display:none}.xano-hs-trigger{display:inline-flex;align-items:center;gap:0.5rem;padding:0.5rem 1rem;font-size:0.875rem;font-weight:600;line-height:1.25rem;color:#ffffff;background-color:#3884ff;border:none;border-radius:0.5rem;cursor:pointer;transition:background-color 0.15s ease, transform 0.15s ease}.xano-hs-trigger:hover{background-color:#2f74e6}.xano-hs-trigger:active{transform:translateY(1px)}.xano-hs-trigger:focus-visible{outline:2px solid #3884ff;outline-offset:2px}.xano-hs-trigger--header{margin-right:0.5rem;padding:0.375rem 0.75rem;border-radius:0.75rem;font-weight:500;color:#ffffff;background-color:#3884ff;white-space:nowrap;flex-shrink:0}.xano-hs-trigger--header:hover{background-color:#2f74e6}#page-context-menu{flex-wrap:wrap;row-gap:0.5rem}.xano-hs-overlay{position:fixed;inset:0;z-index:2147483000;display:flex;align-items:flex-start;justify-content:center;padding:1.5rem;overflow-y:auto;background-color:rgba(15, 17, 21, 0.55);backdrop-filter:blur(2px)}.xano-hs-modal{position:relative;width:100%;max-width:30rem;margin:auto;padding:1.75rem;border-radius:0.875rem;background-color:#ffffff;border:1px solid rgba(0, 0, 0, 0.08);box-shadow:0 24px 48px -12px rgba(0, 0, 0, 0.35);color:#1a1c20}html.dark .xano-hs-modal{background-color:#1a1c20;border-color:rgba(255, 255, 255, 0.1);color:#f2f3f5}.xano-hs-close{position:absolute;top:0.75rem;right:0.75rem;width:2rem;height:2rem;display:flex;align-items:center;justify-content:center;font-size:1.25rem;line-height:1;color:inherit;opacity:0.55;background:transparent;border:none;border-radius:0.375rem;cursor:pointer}.xano-hs-close:hover{opacity:1;background:rgba(127, 127, 127, 0.14)}.xano-hs-title{margin:0 1.75rem 0.375rem 0;font-size:1.125rem;font-weight:600;line-height:1.4}.xano-hs-subtitle{margin:0 0 1.25rem 0;font-size:0.875rem;line-height:1.5;opacity:0.7}.xano-hs-status{font-size:0.875rem;line-height:1.5;opacity:0.7}.xano-hs-status--error{color:#dc2626;opacity:1}html.dark .xano-hs-status--error{color:#f87171}.xano-hs-row{display:grid;grid-template-columns:1fr 1fr;gap:0 0.75rem}@media (max-width: 480px){.xano-hs-row{grid-template-columns:1fr}}.xano-hs-form .hs-form-field{margin-bottom:0.875rem}.xano-hs-form label{display:block;margin-bottom:0.3rem;font-size:0.8125rem;font-weight:500}.xano-hs-form .hs-form-required{color:#dc2626;margin-left:0.15rem}.xano-hs-form .hs-input:not([type=\"checkbox\"]):not([type=\"radio\"]){width:100%;box-sizing:border-box;padding:0.5rem 0.7rem;font-size:0.875rem;font-family:inherit;color:inherit;background-color:rgba(127, 127, 127, 0.07);border:1px solid rgba(127, 127, 127, 0.3);border-radius:0.5rem}.xano-hs-form .hs-input:focus{outline:none;border-color:#3884ff;box-shadow:0 0 0 3px rgba(56, 132, 255, 0.2)}.xano-hs-form .hs-error-msgs{margin:0.35rem 0 0 0;padding:0;list-style:none}.xano-hs-form .hs-error-msgs li{padding:0!important;margin:0!important}.xano-hs-form .hs-error-msgs li::before{display:none!important}.xano-hs-form .hs-error-msgs label{margin:0;font-weight:400;font-size:0.8125rem;color:#dc2626}html.dark .xano-hs-form .hs-error-msgs label{color:#f87171}.xano-hs-form .legal-consent-container{font-size:0.75rem;line-height:1.5}.xano-hs-form .legal-consent-container p{margin:0 0 0.625rem 0;opacity:0.75}.xano-hs-form .legal-consent-container a{color:#3884ff}.xano-hs-form .xano-hs-consent{display:flex;align-items:flex-start;gap:0.5rem;margin-bottom:0.625rem}.xano-hs-form .xano-hs-consent input{flex:none;width:1rem;height:1rem;margin:0.1rem 0 0 0;accent-color:#3884ff;cursor:pointer}.xano-hs-form .xano-hs-consent label{margin:0;font-size:0.8125rem;line-height:1.4;cursor:pointer}.xano-hs-form .xano-hs-consent+.hs-error-msgs{margin:-0.3rem 0 0.625rem 1.5rem}.xano-hs-form .hs-button{width:100%;margin-top:0.5rem;padding:0.55rem 1rem;font-size:0.875rem;font-weight:600;font-family:inherit;color:#ffffff;background-color:#3884ff;border:none;border-radius:0.5rem;cursor:pointer}.xano-hs-form .hs-button:hover{background-color:#2f74e6}.xano-hs-form .hs-button:disabled{opacity:0.7;cursor:progress}.xano-hs-form .hs-button:focus-visible{outline:2px solid #3884ff;outline-offset:2px}.xano-hs-form .xano-hs-status{margin-bottom:0.5rem}.xano-hs-toast{position:fixed;left:50%;bottom:1.5rem;z-index:2147483000;transform:translateX(-50%);width:max-content;max-width:calc(100vw - 2rem);padding:0.75rem 1rem;font-size:0.875rem;line-height:1.5;color:#ffffff;background-color:#1a1c20;border:1px solid rgba(255, 255, 255, 0.1);border-left:3px solid #3884ff;border-radius:0.625rem;box-shadow:0 12px 32px -8px rgba(0, 0, 0, 0.35)}.xano-hs-toast[hidden]{display:none}html.dark .xano-hs-toast{color:#1a1c20;background-color:#ffffff;border-color:rgba(0, 0, 0, 0.08);border-left-color:#3884ff}"}],"page":{"pagePath":"ai-tools/mcp-builder","slug":"/ai-tools/mcp-builder","pageMetadata":{"title":"MCP Builder","sidebarTitle":"MCP Builder","description":null,"href":"/ai-tools/mcp-builder"},"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`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,CodeBlock,CodeGroup,Frame,Heading,Icon,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`MCP`}),` — the Model Context Protocol — is a standard way for AI models to interact with services outside of themselves, like your Xano database. Each individual action you expose to a model is called a `,_jsx(_components.strong,{children:`tool`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Xano’s `,_jsx(_components.strong,{children:`MCP Builder`}),` lets you build those tools exactly the way you build any other function stack, and expose them to any client that supports MCP — Claude, Cursor, ChatGPT, or one you build yourself.`]}),`\n`,_jsx(Heading,{level:`2`,id:`why-build-mcp-servers-in-xano`,children:`Why build MCP servers in Xano?`}),`\n`,_jsxs(_components.p,{children:[`Instead of being limited to REST APIs designed for web and mobile apps, you can build `,_jsx(_components.strong,{children:`AI-native functionality`}),`: function stacks meant to be called by an AI model in response to a request like `,_jsx(_components.em,{children:`“Check the user table for any admins that haven’t logged in since the first of the month, and send them a reminder about our activity policies.”`})]}),`\n`,_jsx(_components.p,{children:`That means you can create tools for your AI to:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Retrieve specific data from your Xano database based on natural language queries`}),`\n`,_jsx(_components.li,{children:`Perform complex data manipulations and calculations triggered by AI insights`}),`\n`,_jsx(_components.li,{children:`Write data back to your Xano database based on AI-driven decisions or user requests interpreted by the AI`}),`\n`,_jsx(_components.li,{children:`Interact with external APIs and services through your Xano function stacks, orchestrated by the AI`}),`\n`,_jsx(_components.li,{children:`Interact with the APIs and services you’ve already built in Xano`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Not building for MCP specifically, and just want a chatbot or a connection to a model like ChatGPT? See `,_jsx(_components.a,{href:`/building-backend-features/chatbots`,children:`Chatbots`}),` instead.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-supported-with-xano’s-mcp-builder`,children:`What’s supported with Xano’s MCP Builder?`}),`\n`,_jsxs(_components.p,{children:[`Servers you build in Xano speak `,_jsx(_components.strong,{children:`Streamable HTTP`}),`, the transport the official MCP SDK has standardized on — that’s the connection URL to hand your clients, and the one to build against. You can use any function we have today in your MCP servers.`]}),`\n`,_jsxs(_components.p,{children:[`Xano MCP servers support the `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`2026-07-28`})}),` MCP specification, and keep serving clients on every earlier version (`,_jsx(_components.code,{children:`2024-11-05`}),`, `,_jsx(_components.code,{children:`2025-03-26`}),`, `,_jsx(_components.code,{children:`2025-06-18`}),` and `,_jsx(_components.code,{children:`2025-11-25`}),`) from the same URL. There’s nothing to configure: each client gets every feature its version supports, and existing clients keep working as before.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Feature`}),_jsx(_components.th,{children:`What it gives you`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/prompts-and-resources`,children:`Tools, prompts and resources`})}),_jsx(_components.td,{children:`Expose actions, reusable message templates, and readable data, each built as its own workspace object.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`#tool-metadata`,children:`Tool metadata`})}),_jsx(_components.td,{children:`A display title, behavior hints, icons, and an output schema for each tool.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`#structured-output`,children:`Structured output`})}),_jsxs(_components.td,{children:[`Validated `,_jsx(_components.code,{children:`structuredContent`}),` from tools with an output schema, which MCP Apps in Claude read.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/mcp-functions#ask-the-user-elicit`,children:`Ask the user`})}),_jsx(_components.td,{children:`Request input from the client’s user partway through a request (elicitation).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/mcp-functions#report-progress`,children:`Progress`})}),_jsx(_components.td,{children:`Send progress updates during long-running work.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/prompts-and-resources#argument-autocomplete`,children:`Argument autocomplete`})}),_jsx(_components.td,{children:`Suggestions for prompt arguments and resource template variables.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`#change-notifications`,children:`Change notifications`})}),_jsx(_components.td,{children:`Clients learn about added, removed or changed tools, prompts and resources without reconnecting.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/sign-in`,children:`OAuth sign-in`})}),_jsx(_components.td,{children:`Clients sign each user in, with Xano or your own identity provider as the authorization server.`})]})]})]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`The older `,_jsx(_components.strong,{children:`SSE`}),` transport was `,_jsx(_components.strong,{children:`removed in v2.6`}),`. Existing `,_jsx(_components.code,{children:`/sse`}),` connection URLs no longer work. Switch each client to the streaming URL — it’s under `,_jsxs(`span`,{class:`ui-bubble`,children:[_jsx(Icon,{icon:`link`}),`Connect this backend`]}),` → `,_jsx(`span`,{class:`ui-bubble`,children:`MCP Server URLs`}),`. See the `,_jsx(_components.a,{href:`/updates`,children:`v2.6 release notes`}),` for the full notice.`]}),_jsxs(_components.p,{children:[`This applies only to MCP servers you build and host in Xano. The `,_jsx(_components.a,{href:`/ai-tools/xano-mcp-server`,children:`Xano MCP Server`}),` and the `,_jsx(_components.a,{href:`/developer-mcp/get-started`,children:`Developer MCP`}),` are unaffected.`]})]}),`\n`,_jsx(_components.p,{children:`As MCP is an evolving protocol, we aim to continue to expand the functionality as it develops. If you are utilizing MCP in Xano and have any feedback or questions, please reach out to our support team.`}),`\n`,_jsx(Heading,{level:`2`,id:`getting-started-with-mcp-builder`,children:`Getting Started with MCP Builder`}),`\n`,_jsx(Heading,{level:`3`,id:`first-create-an-mcp-server`,children:`First, create an MCP Server.`}),`\n`,_jsx(_components.p,{children:`To build MCP servers in Xano, we’ll first need to create a server that will house some tools.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`From the sidebar, click Agents \u0026 MCP`}),_jsx(Step,{title:`Click + Add MCP Server to create your first MCP server`}),_jsx(Step,{title:`Fill out the necessary information`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Name`}),` - Give your server a name that clearly indicates its purpose.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Description`}),` - This is an internal field just for you to expand on the\npurpose of the MCP server.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Allow Connections`}),` - Choose whether or not to allow connections to this MCP server`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Add Tag`}),` - Tag your MCP servers for easier search throughout your Xano workspace.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`MCP Instructions`}),` - These instructions are what your clients will look at to understand the purpose of the MCP server. Markdown format is recommended for easy readability for your LLMs and clients. These instructions apply to the server as a whole, and are not used for individual tool instructions.`]}),`\n`]}),`\n`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`after-you’ve-created-a-server-add-some-tools`,children:`After you’ve created a server, add some tools.`}),`\n`,_jsx(Heading,{level:`4`,id:`what-is-a-tool`,children:`What is a tool?`}),`\n`,_jsx(_components.p,{children:`Tools are essentially individual actions that your MCP server can perform, such as querying a database, adding new records, or calling an external API. You’ll build tools just like you build any other function stack.`}),`\n`,_jsxs(_components.p,{children:[`Most of the time you already have the logic — an `,_jsx(_components.strong,{children:`API endpoint`}),` or a `,_jsx(_components.strong,{children:`function stack`}),` you built for your app. `,_jsx(_components.a,{href:`#using-existing-function-stacks-as-tools`,children:`Exposing one of those as a tool`}),` is a couple of clicks and leaves you with one stack to maintain, so start there. `,_jsx(_components.a,{href:`#creating-tools-from-scratch`,children:`Build a tool from scratch`}),` when there’s nothing to reuse.`]}),`\n`,_jsx(Heading,{level:`4`,id:`tools-prompts-and-resources`,children:`Tools, prompts and resources`}),`\n`,_jsxs(_components.p,{children:[`An MCP server can offer three kinds of things. Each one is its own workspace object that you build once and attach to one or more servers. The server page has a tab for each, and the `,_jsxs(`span`,{class:`ui-bubble`,children:[_jsx(Icon,{icon:`plug`}),`Connect`]}),` menu attaches them: `,_jsx(_components.strong,{children:`Connect Tool`}),`, `,_jsx(_components.strong,{children:`Connect Prompt`}),` or `,_jsx(_components.strong,{children:`Connect Resource`}),`.`]}),`\n`,_jsx(Card,{title:`Tool`,icon:`hammer`,horizontal:true,children:_jsxs(_components.p,{children:[`A tool is an action that your MCP server can perform. Each tool has its own set of logic that defines its behavior, such as querying a database, adding new records, or calling an external API. Usually that logic is an `,_jsx(_components.strong,{children:`API endpoint`}),` or a `,_jsx(_components.strong,{children:`function stack`}),` you already built — you expose it as a tool rather than rewriting it.`]})}),`\n`,_jsx(Card,{title:`Prompt`,icon:`message`,horizontal:true,href:`/ai-tools/mcp-builder/prompts-and-resources#prompts`,children:_jsx(_components.p,{children:`A prompt is a reusable message template with arguments, which a user picks from their client, such as “Summarize this order.”`})}),`\n`,_jsx(Card,{title:`Resource`,icon:`page`,horizontal:true,href:`/ai-tools/mcp-builder/prompts-and-resources#resources`,children:_jsxs(_components.p,{children:[`Resources share data that gives language models context, such as files, records, or generated content. Each resource is identified by a URI, which can be a template like `,_jsx(_components.code,{children:`orders://{order_id}`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`To change how an attached tool behaves on one server, click the `,_jsx(`span`,{class:`ui-bubble`,children:`⋮`}),` icon next to it and select `,_jsxs(`span`,{class:`ui-bubble`,children:[_jsx(Icon,{icon:`gear`}),`Connection Settings`]}),`. There you can turn the tool on or off with `,_jsx(_components.strong,{children:`Allow Connections`}),`, set its `,_jsx(_components.strong,{children:`Authentication`}),`, and add `,_jsx(_components.strong,{children:`Tool Meta`}),`. These settings apply only to that server.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Resources used to be a `,_jsx(_components.strong,{children:`Tool Type`}),` you set in `,_jsx(_components.strong,{children:`Connection Settings`}),`. Those legacy resource tools still work, but new resources should be `,_jsx(_components.a,{href:`/ai-tools/mcp-builder/prompts-and-resources#resources`,children:`resource objects`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`using-existing-function-stacks-as-tools`,children:`Using Existing Function Stacks as Tools`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`In the existing function stack, click the ⋮ settings icon in the upper-right corner and click Use As AI Tool`}),_jsx(Step,{title:`Choose the MCP Server you'd like to add the tool to, and give it a name. This name is what the command will be, so make sure it's understandable`}),_jsxs(Step,{title:`Navigate to your MCP Server and check for the newly created tool`,children:[_jsx(_components.p,{children:`Xano will not make a copy of your existing function stack; instead, it will use a Run Endpoint function and call that API internally. This is ideal so you only have to maintain one function stack.`}),_jsx(Frame,{caption:`A tool created from an existing API endpoint`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=430322aa1c18b9231d6b3e1a4e7d5fb5`,alt:``,\"data-og-width\":`1328`,width:`1328`,\"data-og-height\":`911`,height:`911`,\"data-path\":`images/5d3f516b-image.jpeg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?w=280\u0026fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=c510205ee8f760fc5afdc58ffd7558dd 280w, https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?w=560\u0026fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=20f1211c29cbe8368ef3e150c1ea1b31 560w, https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?w=840\u0026fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=54347b2be3297e469ec7ceba39245ac7 840w, https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?w=1100\u0026fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=a8e722cca56fdab3a994b5d7c9969ee8 1100w, https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?w=1650\u0026fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=69660942bb4c212602079aec8b0a7b65 1650w, https://mintcdn.com/xano-997cb9ee/MSaUdHhXgkZO-GXY/images/5d3f516b-image.jpeg?w=2500\u0026fit=max\u0026auto=format\u0026n=MSaUdHhXgkZO-GXY\u0026q=85\u0026s=457df8d32aa03b0b8353b96c2d1d883c 2500w`})})]}),_jsx(Step,{title:`Adjust the settings for your newly created tool and add instructions`,children:_jsx(_components.p,{children:`Instructions are important to have so the AI models and clients interacting with this tool understand how to use it.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`creating-tools-from-scratch`,children:`Creating Tools from Scratch`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`In your MCP Server, click + Add Tool`}),_jsx(Step,{title:`Fill out the required information`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Give your tool a recognizable name. This is also the command that will be used to execute your tool.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Description`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`This is an internal-only field just for you to describe the purpose of the tool.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Allow Connections`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Enable or disable connection to this specific tool`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Add Tag`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Tag your tools for easier search across your Xano workspace`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Authentication`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Determine if this tool requires an authentication token`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tool Instructions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`These instructions are what your clients will use to understand how to send requests to the tool, and what the expected result will be. Markdown format is recommended.`}),`\n`]}),`\n`]}),`\n`]})}),_jsxs(Step,{title:`Build your tool's function stack`,children:[_jsxs(_components.p,{children:[`If you haven’t already, make sure you’re familiar with Xano’s `,_jsx(_components.a,{href:`/the-function-stack/building-with-visual-development`,children:`visual builder`}),`.`]}),_jsx(_components.p,{children:`We also have some specific functions that may be useful to you when building tools that allow you to interact with existing function stacks.`}),_jsx(_components.p,{children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/mcp-functions`,children:`MCP Functions`})})]}),_jsx(Step,{title:`When you're ready, publish your changes`})]}),`\n`,_jsx(Heading,{level:`2`,id:`tool-metadata`,children:`Tool metadata`}),`\n`,_jsxs(_components.p,{children:[`Beyond its name and instructions, a tool can tell clients how to display it and what it returns. Open the tool, then `,_jsx(`span`,{class:`ui-bubble`,children:`⋮`}),` → `,_jsx(`span`,{class:`ui-bubble`,children:`Settings`}),`. `,_jsx(_components.strong,{children:`Title`}),` sits under the name, and the rest is in the `,_jsx(_components.strong,{children:`MCP`}),` section. All of it is optional, and a tool sends only what you set.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Title`})}),_jsxs(_components.td,{children:[`A human-friendly display name clients may show instead of the tool’s name, such as “Look Up an Order” for `,_jsx(_components.code,{children:`lookup_order`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Annotations`})}),_jsxs(_components.td,{children:[`Hints about the tool’s behavior. Each is `,_jsx(_components.strong,{children:`Not set`}),`, `,_jsx(_components.strong,{children:`Yes`}),` or `,_jsx(_components.strong,{children:`No`}),`. Clients treat them as untrusted hints, and Xano doesn’t enforce them.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Icons`})}),_jsx(_components.td,{children:`Images clients may display next to the tool.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Output Schema`})}),_jsxs(_components.td,{children:[`The shape of the tool’s result. With one, the tool returns `,_jsx(_components.a,{href:`#structured-output`,children:`structured output`}),`.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`The four annotations are:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Annotation`}),_jsx(_components.th,{children:`Means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Read Only`})}),_jsx(_components.td,{children:`The tool doesn’t modify its environment.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Destructive`})}),_jsx(_components.td,{children:`The tool may perform destructive updates. Only meaningful when it isn’t read only.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Idempotent`})}),_jsx(_components.td,{children:`Calling the tool repeatedly with the same arguments has no additional effect. Only meaningful when it isn’t read only.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Open World`})}),_jsx(_components.td,{children:`The tool may interact with an open world of external entities, such as the web.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Each icon has a source, plus an optional MIME type, sizes (`,_jsx(_components.code,{children:`48x48`}),`, or `,_jsx(_components.code,{children:`any`}),`) and theme (`,_jsx(_components.code,{children:`light`}),` or `,_jsx(_components.code,{children:`dark`}),`). The source must be an `,_jsx(_components.code,{children:`https`}),` URL or a base64 `,_jsx(_components.code,{children:`data:`}),` URI of a PNG, JPEG or WebP image of at most 64 KiB. Click `,_jsx(`span`,{class:`ui-bubble`,children:`Upload Image`}),` to save an image to your workspace `,_jsx(_components.a,{href:`/file-storage/file-storage-in-xano`,children:`Files`}),` and fill in the icon for you. SVG and `,_jsx(_components.code,{children:`http`}),` URLs aren’t accepted.`]}),`\n`,_jsxs(_components.p,{children:[`Prompts and resources take a `,_jsx(_components.strong,{children:`Title`}),` and `,_jsx(_components.strong,{children:`Icons`}),` in the same way.`]}),`\n`,_jsxs(_components.p,{children:[`In XanoScript, these are fields on the `,_jsx(_components.code,{children:`tool`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:`ai/tool/lookup_order.xs`,numberOfLines:`38`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`38`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`tool lookup_order {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` title = \"Look up an order\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` annotations = {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` read_only_hint : true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` destructive_hint: false`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` idempotent_hint : true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` open_world_hint : false`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` icons = [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` src : \"https://cdn.example.com/icons/order.webp\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` sizes: [\"any\"]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` theme: \"light\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` input {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` int order_id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` stack {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` db.get order {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` field_name = \"id\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` field_value = $input.order_id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` } as $order`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` response = $order`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` output {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` int id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` enum status {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` values = [\"open\", \"closed\"]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`structured-output`,children:`Structured output`}),`\n`,_jsx(_components.p,{children:`A tool’s result reaches the client in one of two ways, depending on whether it has an output schema.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Without an output schema`}),`, the tool returns its result as text, exactly as before. Strings are sent as they are, and anything else as JSON.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`With an output schema`}),`, Xano validates the result against the schema and returns it as `,_jsx(_components.code,{children:`structuredContent`}),`, alongside the same JSON as text for clients that don’t read structured content. The tool also advertises the schema as its `,_jsx(_components.code,{children:`outputSchema`}),`, so clients know the shape in advance.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:42,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`open`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"structuredContent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The result must be an object, every required field must be there, and types and enum values must match. Extra fields are allowed. If the result doesn’t match, the client gets an error result naming the problem, such as `,_jsx(_components.code,{children:`Tool output does not match its output schema: items[0].name: expected a string, got int`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`A tool with an output schema can also return a full MCP tool result that it builds itself, with `,_jsx(_components.code,{children:`content`}),`, `,_jsx(_components.code,{children:`structuredContent`}),`, `,_jsx(_components.code,{children:`isError`}),` and `,_jsx(_components.code,{children:`_meta`}),`. Xano passes it through, after validating its `,_jsx(_components.code,{children:`structuredContent`}),`.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`MCP Apps in Claude read `,_jsx(_components.code,{children:`structuredContent`})]}),`, so give a tool an output schema to send its data to an MCP App’s interface. Existing tools without one keep returning the same text results.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Building an app to run right inside of ChatGPT? Serve its interface as a `,_jsx(_components.a,{href:`/ai-tools/mcp-builder/prompts-and-resources#resources`,children:`resource`}),` — see `,_jsx(_components.a,{href:`https://youtu.be/KjPMTeMuaeQ`,children:`Build apps in ChatGPT with Xano`}),`. The video predates resource objects and uses the legacy Resource tool type, but the approach is the same.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`mcp-authentication`,children:`MCP Authentication`}),`\n`,_jsx(_components.p,{children:`Your MCP tools can require authentication, and there are two ways a client can satisfy it.`}),`\n`,_jsx(Heading,{level:`3`,id:`a-bearer-token-on-the-authorization-header`,children:`A bearer token on the Authorization header`}),`\n`,_jsxs(_components.p,{children:[`Set a tool’s `,_jsx(_components.strong,{children:`Authentication`}),` on, and Xano validates the token the same way it does for the secure APIs you’re already building. You paste that token into your client’s config and it rides along with every request.`]}),`\n`,_jsxs(_components.p,{children:[`This is the quick path, and it’s all most header-capable clients need — Claude Code, Cursor, VS Code, Windsurf, Antigravity, Raycast, Warp, Gemini CLI, Codex CLI. See `,_jsx(_components.a,{href:`/ai-tools/mcp-builder/connecting-clients`,children:`Connecting Clients`}),` for the per-client setup.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A header token is shared, not per-user.`}),` Every client configured with it sends the same credential, so Xano sees one identity no matter who is asking. `,_jsx(_components.code,{children:`$auth`}),` can’t tell your users apart, tools can’t scope data to the caller, and revoking access for one person means rotating the token for everyone.`]}),_jsx(_components.p,{children:`That’s a reasonable gate for you and your team on your own machines. It stops being one the moment you ship an MCP server to people who should each see only their own data.`})]}),`\n`,_jsx(Heading,{level:`3`,id:`oauth-sign-in-for-per-user-identity-and-oauth-only-clients`,children:`OAuth sign-in, for per-user identity and OAuth-only clients`}),`\n`,_jsxs(_components.p,{children:[`Turn on `,_jsx(_components.strong,{children:`Sign-in (OAuth)`}),` in the server’s settings, and clients sign each user in before they connect. Every request then arrives as the person who made it, and `,_jsx(_components.code,{children:`$auth`}),` scopes data per user natively. There are two modes:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Hosted:`}),` Xano is the authorization server, and your own login page signs the user in.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`External:`}),` your identity provider, such as Auth0, WorkOS, Clerk, Microsoft Entra ID, Okta or Amazon Cognito, signs the user in, and Xano verifies its JWT access tokens.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`You need this when:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Your client can’t send a header at all.`}),` Claude Web, Claude mobile, Claude Desktop’s `,_jsx(_components.strong,{children:`Add custom connector`}),` dialog, ChatGPT developer mode, and Microsoft 365 Copilot are OAuth-only.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`You need per-user identity`}),` — on any client, including the header-capable ones.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A token in the connection URL isn’t a third option.`}),` The MCP spec has prohibited access tokens in the URI query string since its `,_jsx(_components.code,{children:`2025-06-18`}),` revision, and the Claude surfaces run an OAuth handshake for every custom connector — so a URL token sends you to a consent page that can’t complete.`]})}),`\n`,_jsx(_components.p,{children:`Once sign-in is on, the whole server requires it, and session tokens sent in a header are refused.`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Require sign-in (OAuth)`,icon:`key`,href:`/ai-tools/mcp-builder/sign-in`,children:_jsx(_components.p,{children:`Turn on hosted or external sign-in, build the login handoff, and set up your identity provider.`})}),_jsx(Card,{title:`Bring your own identity provider`,icon:`cloud`,href:`/ai-tools/mcp-builder/oauth-proxy`,children:_jsx(_components.p,{children:`Run your own OAuth front end with a Cloudflare Worker, for setups built-in sign-in doesn’t cover.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`connection-urls-and-branches`,children:`Connection URLs and branches`}),`\n`,_jsxs(_components.p,{children:[`Each server’s connection URL is under `,_jsxs(`span`,{class:`ui-bubble`,children:[_jsx(Icon,{icon:`link`}),`Connection URL`]}),` on its card in the MCP Servers list, and `,_jsx(`span`,{class:`ui-bubble`,children:`Copy Connection URL`}),` on the server’s page.`]}),`\n`,_jsx(_components.p,{children:`The URL follows the branch you’re working on. On a non-live branch, the branch name is added to the server’s canonical after a colon, so you can connect a client to a branch and test it before you make it live. A URL without a branch always reaches the live branch.`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Shape`,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://{instance-host}/x2/mcp/{canonical}:{branch}/mcp/stream`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Example`,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://x8ki-letl-twmt.n7.xano.io/x2/mcp/67Dx5RNL:dev/mcp/stream`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`change-notifications`,children:`Change notifications`}),`\n`,_jsxs(_components.p,{children:[`Clients on the `,_jsx(_components.code,{children:`2026-07-28`}),` specification can listen for changes to a server. When you add, remove or edit an attached tool, prompt or resource in a way the client would see, such as its name, title, description, inputs or icons, connected clients are told to re-list. Edits to a stack alone don’t trigger a notification. There’s nothing to build: Xano sends them automatically.`]}),`\n`,_jsx(Heading,{level:`2`,id:`url-parameters`,children:`URL parameters`}),`\n`,_jsxs(_components.p,{children:[`You can pass URL parameters as part of your connection URL, such as `,_jsx(_components.code,{children:`?beta=true`}),`, and read them in your tool function stacks as the `,_jsx(_components.code,{children:`params`}),` variable to change how the tools behave.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Shape`,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://{instance-host}/x2/mcp/{canonical}/mcp/stream?{param}={value}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Example`,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://x8ki-letl-twmt.n7.xano.io/x2/mcp/67Dx5RNL/mcp/stream?beta=true\u0026region=eu`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsxs(_components.p,{children:[`Combine them with `,_jsx(_components.a,{href:`/building/logic/triggers/mcp-servers`,children:`Triggers`}),` for more complex MCP logic.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connecting-to-your-mcp-server`,children:`Connecting to your MCP Server`}),`\n`,_jsx(_components.p,{children:`Now that you’ve built an MCP server and added some tools to it, you can connect with your client of choice. Choose from the list below for a quick getting started guide.`}),`\n`,_jsx(_components.p,{children:`If you’re new to MCP servers, we recommend starting with Cursor.`}),`\n`,_jsx(Heading,{level:`4`,id:`cursor`,children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/connecting-clients#cursor`,children:`Cursor`})}),`\n`,_jsx(Heading,{level:`4`,id:`claude-code`,children:_jsx(_components.a,{href:`/ai-tools/mcp-builder/connecting-clients#claude-code`,children:`Claude Code`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`video-walkthroughs`,children:`Video walkthroughs`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{icon:`youtube`,color:`#bf0000`,href:`https://youtu.be/VQGjbBBY96s`,img:`/images/70212fa8-image.jpeg`,children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`Introduction to MCP`})})}),_jsx(Card,{icon:`youtube`,color:`#bf0000`,href:`https://youtu.be/5-K4nCW1YHE`,img:`/images/d15b18c8-image.jpeg`,children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`Build an MCP Server in 10min or Less`})})}),_jsx(Card,{icon:`youtube`,color:`#bf0000`,href:`https://youtu.be/5k6VcKu0AJU`,img:`/images/cbf3184d-image.jpeg`,children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`MCP Tools and Functions`})})}),_jsx(Card,{icon:`youtube`,color:`#bf0000`,href:`https://youtu.be/5M6Qx6-rcbo`,img:`/images/01921a63-image.jpeg`,children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`Building an MCP Server \u0026 Client`})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsx(_components.p,{children:`There are some best practices when building tools that we recommend following for the best experience.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/the-database/database-basics/field-types#-enum`,children:`Use enum inputs wherever possible`})}),` so the AI model understands what options are available for your inputs.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.strong,{children:`clear naming conventions`}),` and instructions.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Try to find a balance when writing instructions`}),` between being clear and descriptive, but also concise. Reducing the amount of tokens sent to an AI model will reduce token cost, improve speed, and improve responses.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use error handling with clear error messages`}),`. If an AI model fails to use a tool, clear error messages will allow it to retry the tool successfully.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(`div`,{\"data-faq-controls\":true}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`What are the benefits of using MCP?`,id:`what-are-the-benefits-of-using-mcp`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Standardization:`}),` MCP provides a common way for different applications and LLMs to interact, reducing the need for custom integrations.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Interoperability:`}),` MCP enables different LLMs and applications to work together more easily.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Flexibility:`}),` MCP allows developers to connect LLMs to a wide range of external resources.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Efficiency:`}),` MCP streamlines the process of building AI agents and applications.`]}),`\n`]})}),_jsx(Accordion,{title:`Is MCP tied to a specific LLM or platform?`,id:`is-mcp-tied-to-a-specific-llm-or-platform`,children:_jsx(_components.p,{children:`No, MCP is designed to be an open and vendor-neutral protocol, allowing it to be used with various LLMs and platforms.`})}),_jsx(Accordion,{title:`How does MCP relate to APIs?`,id:`how-does-mcp-relate-to-apis`,children:_jsx(_components.p,{children:`While APIs provide access to specific functions, MCP provides a standardized way for LLMs to discover and use those functions in a context-aware manner.`})}),_jsx(Accordion,{title:`What is the role of “context” in MCP?`,id:`what-is-the-role-of-context-in-mcp`,children:_jsx(_components.p,{children:`Context is crucial in MCP. It provides the LLM with the necessary information about the user’s request, the available tools, and the overall environment, enabling the LLM to make more informed decisions.`})}),_jsx(Accordion,{title:`How is security handled in MCP?`,id:`how-is-security-handled-in-mcp`,children:_jsx(_components.p,{children:`MCP emphasizes secure communication between clients and servers. Mechanisms like authentication, authorization, and secure data transfer are important considerations in MCP implementations.`})}),_jsx(Accordion,{title:`Can I build multiple MCP servers?`,id:`can-i-build-multiple-mcp-servers`,children:_jsx(_components.p,{children:`Yes, in Xano you can build multiple MCP servers and they can all have their own tools available.`})})]})]})}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":"MCP Builder","sidebarTitle":"MCP Builder","description":null,"href":"/ai-tools/mcp-builder"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Why build MCP servers in Xano?","slug":"why-build-mcp-servers-in-xano","depth":2,"children":[]},{"title":"What’s supported with Xano’s MCP Builder?","slug":"what’s-supported-with-xano’s-mcp-builder","depth":2,"children":[]},{"title":"Getting Started with MCP Builder","slug":"getting-started-with-mcp-builder","depth":2,"children":[{"title":"First, create an MCP Server.","slug":"first-create-an-mcp-server","depth":3,"children":[]},{"title":"After you’ve created a server, add some tools.","slug":"after-you’ve-created-a-server-add-some-tools","depth":3,"children":[]},{"title":"What is a tool?","slug":"what-is-a-tool","depth":4,"children":[]},{"title":"Tools, prompts and resources","slug":"tools-prompts-and-resources","depth":4,"children":[]},{"title":"Using Existing Function Stacks as Tools","slug":"using-existing-function-stacks-as-tools","depth":3,"children":[]},{"title":"Creating Tools from Scratch","slug":"creating-tools-from-scratch","depth":3,"children":[]}]},{"title":"Tool metadata","slug":"tool-metadata","depth":2,"children":[{"title":"Structured output","slug":"structured-output","depth":3,"children":[]}]},{"title":"MCP Authentication","slug":"mcp-authentication","depth":2,"children":[{"title":"A bearer token on the Authorization header","slug":"a-bearer-token-on-the-authorization-header","depth":3,"children":[]},{"title":"OAuth sign-in, for per-user identity and OAuth-only clients","slug":"oauth-sign-in-for-per-user-identity-and-oauth-only-clients","depth":3,"children":[]}]},{"title":"Connection URLs and branches","slug":"connection-urls-and-branches","depth":2,"children":[]},{"title":"Change notifications","slug":"change-notifications","depth":2,"children":[]},{"title":"URL parameters","slug":"url-parameters","depth":2,"children":[]},{"title":"Connecting to your MCP Server","slug":"connecting-to-your-mcp-server","depth":2,"children":[{"title":"Cursor","slug":"cursor","depth":4,"children":[]},{"title":"Claude Code","slug":"claude-code","depth":4,"children":[]}]},{"title":"Video walkthroughs","slug":"video-walkthroughs","depth":2,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/xano-997cb9ee/7ccbde81bbdf9fb7/remark-link-graph.js","/_mintlify/custom/xano-997cb9ee/8b02dc1f3860c4eb/iconvisibility.js","/_mintlify/custom/xano-997cb9ee/8bba6e93fd00475c/chat-dim.js","/_mintlify/custom/xano-997cb9ee/f6ebfcfeda318efb/toc-indicator.js","/_mintlify/custom/xano-997cb9ee/2152a7ac01bb32e6/accordion-hash.js","/_mintlify/custom/xano-997cb9ee/d9385cd9a5429ca0/faq-controls.js"],"subdomain":"xano-997cb9ee","siteName":"Xano Documentation","title":"MCP Builder - Xano Documentation","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6aebb6e5e06d757a1359e699","deploymentId":"680ff9808abe3a2c762b86fa","questionText":"What can MCP servers do with my data?","status":"active","generatedBy":"contextual","path":"ai-tools/mcp-builder","createdAt":"2026-11-04T22:51:17.557Z","updatedAt":"2026-11-04T22:51:17.557Z","__v":0},{"_id":"6aebb6e5e06d757a1359e698","deploymentId":"680ff9808abe3a2c762b86fa","questionText":"How do I build MCP tools in Xano?","status":"active","generatedBy":"contextual","path":"ai-tools/mcp-builder","createdAt":"2026-11-04T22:51:17.557Z","updatedAt":"2026-11-04T22:51:17.557Z","__v":0},{"_id":"6aebb6e5e06d757a1359e697","deploymentId":"680ff9808abe3a2c762b86fa","questionText":"What is the Model Context Protocol?","status":"active","generatedBy":"contextual","path":"ai-tools/mcp-builder","createdAt":"2026-11-04T22:51:17.557Z","updatedAt":"2026-11-04T22:51:17.557Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T22:50:52.436Z","originalFileLocation":"ai-tools/mcp-builder.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=\"application-name\" content=\"Xano 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/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_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/xano-997cb9ee/cgGwIFviWDgTKtuE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"MCP Builder - Xano Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Visual-first unified backend for modern apps. Build APIs, AI Agents, data, logic, auth, \u0026amp; more—all in one platform.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Xano Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.xano.com/ai-tools/mcp-builder\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xano-997cb9ee.mintlify.site/_mintlify/api/og/v2?division=MCP+Servers\u0026amp;title=MCP+Builder\u0026amp;theme=0109c854116588ad84872d4a\u0026amp;signature=4e93f95c663bfcb16d299d7014676f0dd0dd295f82aaa5ea09db798b3870df71\">\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 Builder - Xano Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Visual-first unified backend for modern apps. Build APIs, AI Agents, data, logic, auth, \u0026amp; more—all in one platform.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xano-997cb9ee.mintlify.site/_mintlify/api/og/v2?division=MCP+Servers\u0026amp;title=MCP+Builder\u0026amp;theme=0109c854116588ad84872d4a\u0026amp;signature=4e93f95c663bfcb16d299d7014676f0dd0dd295f82aaa5ea09db798b3870df71\">\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/xano-997cb9ee/cgGwIFviWDgTKtuE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Xano Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1b62f8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.xano.com/ai-tools/mcp-builder\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai-tools/mcp-builder.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.xano.com/#organization\",\"name\":\"Xano Documentation\",\"url\":\"https://docs.xano.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xano-997cb9ee/hLg--ImSu58u2jLW/logo/logo_wordmark_blue_1_.svg?fit=max\u0026auto=format\u0026n=hLg--ImSu58u2jLW\u0026q=85\u0026s=487b8933249723b2ebc7bf7b6179ea0c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.xano.com#website\",\"name\":\"Xano Documentation\",\"url\":\"https://docs.xano.com\",\"publisher\":{\"@id\":\"https://docs.xano.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.xano.com/ai-tools/mcp-builder#webpage\",\"url\":\"https://docs.xano.com/ai-tools/mcp-builder\",\"name\":\"MCP Builder\",\"dateModified\":\"2026-11-04T22:50:52.436Z\",\"isPartOf\":{\"@id\":\"https://docs.xano.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.xano.com/ai-tools/mcp-builder#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.xano.com/ai-tools/mcp-builder#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build\",\"item\":\"https://docs.xano.com/getting-started-ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP Builder\",\"item\":\"https://docs.xano.com/ai-tools/mcp-builder\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.xano.com/ai-tools/mcp-builder#article\",\"headline\":\"MCP Builder\",\"name\":\"MCP Builder\",\"url\":\"https://docs.xano.com/ai-tools/mcp-builder\",\"mainEntityOfPage\":{\"@id\":\"https://docs.xano.com/ai-tools/mcp-builder#webpage\"},\"dateModified\":\"2026-11-04T22:50:52.436Z\",\"publisher\":{\"@id\":\"https://docs.xano.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.xano.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Xano Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Xano Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ai-tools/mcp-builder.md","siteName":"Xano Documentation","nav":{"global":null,"tabs":[{"tab":"Xano","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xano-997cb9ee/images/icons/xano.svg","pages":[{"title":"Get Started","icon":"rocket","href":""},{"title":"What's New","icon":"newspaper","href":"/updates"},{"title":"Xano — Features \u0026 Capabilities FAQ","sidebarTitle":"FAQ","icon":"circle-question","href":"/frequently-asked-questions"},{"title":"Navigating Xano","icon":"compass","tag":"NEW","href":"/navigating-xano"},{"group":"Build","pages":[{"title":"Build from your Local Agent","sidebarTitle":"Agentic Development","icon":"robot","href":"/getting-started-ai"},{"title":"Xano Agent","tag":"NEW","icon":"wand-magic-sparkles","href":"/building/xano-agent"},{"title":"Knowledge","tag":"NEW","icon":"brain","href":"/agent-knowledge"},{"group":"Logic \u0026 Workflows","icon":"diagram-project","pages":[{"title":"Logic \u0026 Workflows","sidebarTitle":"Logic \u0026 Workflows","icon":"sitemap","href":"/building/logic/logic"},{"title":"Building APIs in Xano","sidebarTitle":"APIs","href":"/building/logic/apis"},{"title":"Building Custom Functions in Xano","sidebarTitle":"Custom Functions","href":"/building/logic/custom-functions"},{"title":"Background Tasks in Xano","sidebarTitle":"Background Tasks","href":"/building/logic/background-tasks"},{"title":"Triggers","href":"/building/logic/triggers"},{"title":"Middleware","href":"/building/logic/middleware"},{"title":"Inputs","sidebarTitle":"Inputs","href":"/building/logic/core-components/inputs"},{"title":"Logic","sidebarTitle":"Logic","href":"/building/logic/core-components/logic"},{"title":"Functions","sidebarTitle":"Functions","href":"/building/logic/core-components/functions"},{"title":"Variables","sidebarTitle":"Variables","href":"/building/logic/working-with-data/variables"},{"title":"Environment Variables","sidebarTitle":"Environment Variables","href":"/building/logic/working-with-data/environment-variables"},{"title":"Filters","sidebarTitle":"Filters","href":"/building/logic/core-components/filters"},{"title":"Response","sidebarTitle":"Response","href":"/building/logic/core-components/response"}]},{"group":"Database","icon":"database","pages":[{"title":"Database Overview","href":"/the-database/database"},{"title":"Database Basics","href":"/the-database/database-basics"},{"title":"Field Types","href":"/the-database/database-basics/field-types"},{"title":"Database Design Fundamentals","href":"/the-database/designing-your-database"},{"title":"Migrating Data to Xano","href":"/the-database/migrating-your-data"},{"title":"Data Sources","href":"/the-database/database-basics/data-sources"},{"title":"Database Views","href":"/the-database/database-basics/database-views"},{"title":"Export And Sharing","href":"/the-database/database-basics/export-and-sharing"},{"title":"Database Performance And Maintenance","href":"/the-database/database-performance-and-maintenance"}]},{"group":"AI Agents","icon":"robot","pages":[{"title":"Agents","href":"/ai-tools/agents"},{"title":"Using OpenTelemetry with AI Agents","sidebarTitle":"OpenTelemetry","href":"/ai-tools/agents/opentelemetry"},{"title":"Templates","description":"Agent Templates","href":"/ai-tools/agents/templates"}]},{"group":"MCP Servers","icon":"plug","pages":[{"title":"MCP Builder","sidebarTitle":"MCP Builder","href":"/ai-tools/mcp-builder"},{"title":"Prompts and Resources","description":"Build MCP prompts and resources as workspace objects in Xano, attach them to your MCP servers, and give clients argument autocomplete.","href":"/ai-tools/mcp-builder/prompts-and-resources"},{"title":"MCP Functions","href":"/ai-tools/mcp-builder/mcp-functions"},{"title":"Connecting Clients","href":"/ai-tools/mcp-builder/connecting-clients"},{"title":"Require sign-in (OAuth) on an MCP server","sidebarTitle":"OAuth Sign-In","href":"/ai-tools/mcp-builder/sign-in"},{"title":"Bring your own identity provider","sidebarTitle":"Bring Your Own IdP","href":"/ai-tools/mcp-builder/oauth-proxy"}]},{"group":"Authentication","icon":"lock-keyhole","pages":[{"title":"User Auth \u0026 Data","href":"/building-backend-features/user-authentication-and-user-data"},{"title":"Separating User Data","href":"/building-backend-features/user-authentication-and-user-data/separating-user-data"},{"title":"Restricting Access (RBAC)","href":"/building-backend-features/user-authentication-and-user-data/restricting-access-rbac"},{"title":"OAuth (SSO)","href":"/building-backend-features/user-authentication-and-user-data/oauth-sso"},{"title":"Best Practices","icon":"shield-check","href":"/security/best-practices"},{"title":"Getting Answers to Security Questions","sidebarTitle":"Security Questionnaires","icon":"clipboard-question","href":"/security/getting-answers-to-security-questions"}]},{"group":"File Storage","icon":"folder-open","pages":[{"title":"File Storage In Xano","sidebarTitle":"File Storage","href":"/file-storage/file-storage-in-xano"},{"title":"Private File Storage","href":"/file-storage/private-file-storage"}]},{"group":"Realtime","icon":"signal-stream","pages":[{"title":"Realtime","sidebarTitle":"Overview","href":"/realtime/overview"},{"title":"Realtime Servers \u0026 Channels","sidebarTitle":"Servers \u0026 Channels","href":"/realtime/realtime-servers-and-channels"},{"title":"Connecting a Realtime Client","sidebarTitle":"Connecting a Client","href":"/realtime/connecting-a-client"},{"title":"Realtime Messages","sidebarTitle":"Messages","href":"/realtime/messages"},{"title":"Realtime Access Control","sidebarTitle":"Access Control","href":"/realtime/access-control"},{"title":"Realtime Triggers","sidebarTitle":"Triggers","href":"/realtime/realtime-triggers"},{"title":"Publishing to a Channel from Xano","sidebarTitle":"Publishing from Xano","href":"/realtime/publishing-from-xano"},{"title":"Legacy Realtime vs Realtime","sidebarTitle":"Legacy vs Realtime","href":"/realtime/migrating-from-legacy-realtime"}]}]},{"group":"Test \u0026 Deploy","pages":[{"group":"Test","icon":"flask","pages":[{"title":"Test Suites","href":"/testing-debugging/test-suites"},{"title":"Unit Tests","href":"/testing-debugging/unit-tests"},{"title":"Ephemeral Tenants","icon":"hourglass-half","tag":"NEW","href":"/xano-cli/ephemeral"},{"title":"Publishing","href":"/the-function-stack/building-with-visual-development/publishing"},{"title":"Swagger/OpenAPI Docs","href":"/the-function-stack/building-with-visual-development/apis/swagger-openapi-documentation"}]},{"group":"Deploy","icon":"cloud-arrow-up","tag":"NEW","pages":[{"title":"Deployment Readiness","icon":"clipboard-check","href":"/deployment-readiness"},{"title":"Static Hosting","href":"/xano-features/static-hosting"},{"title":"Sandbox Testing","tag":"NEW","href":"/testing-debugging/sandbox"},{"group":"Connecting a Frontend","pages":[{"title":"Connecting a Frontend","icon":"browser","href":"/connecting-to-a-frontend/overview"},{"title":"Custom Coded Apps","href":"/connecting-to-a-frontend/custom-coded-apps"},{"title":"AI App Builders","href":"/connecting-to-a-frontend/ai-app-builders"},{"title":"No-Code App Builders","href":"/connecting-to-a-frontend/no-code-builders"}]},{"title":"Git Sync","sidebarTitle":"Git Sync","href":"/xano-features/workspace-settings/git-sync"}]},{"group":"Monitor \u0026 Troubleshoot","icon":"gauge-high","tag":"NEW","pages":[{"title":"Performance Insights","href":"/maintenance-monitoring-and-logging/performance-insights"},{"title":"Request History","tag":"UPDATED","href":"/maintenance-monitoring-and-logging/request-history"},{"title":"Statement Explorer","href":"/maintenance-monitoring-and-logging/statement-explorer"},{"title":"Error Logs","tag":"NEW","href":"/maintenance-monitoring-and-logging/error-logs"},{"title":"Audit Logs","href":"/xano-features/workspace-settings/audit-logs"},{"title":"What to Do If Your APIs Aren't Responding","href":"/troubleshooting-and-support/my-apis-arent-responding"},{"title":"What to Do If Your Instance Is Down","href":"/troubleshooting-and-support/my-instance-is-down"},{"title":"Error Reference","href":"/troubleshooting-and-support/error-reference"},{"title":"Reporting Potential Bugs and Issues","href":"/troubleshooting-and-support/reporting-potential-bugs-and-issues"}]}]},{"group":"Team Collaboration","pages":[{"title":"Team Collaboration","icon":"users","href":"/team-collaboration/team-collaboration"},{"title":"Managing Team Members","icon":"user-gear","href":"/team-collaboration/managing-team-members"},{"title":"Realtime Collaboration","icon":"arrows-rotate","href":"/team-collaboration/realtime-collaboration"},{"title":"Branching \u0026 Merging","icon":"code-branch","href":"/team-collaboration/branching-and-merging"},{"title":"Role Based Access Control (RBAC)","icon":"user-shield","href":"/team-collaboration/role-based-access-control-rbac"}]},{"group":"Integrations","pages":[{"title":"Browse Integrations","url":"https://www.xano.com/connect/","icon":"puzzle-piece","href":"/connect"},{"title":"Webhooks","icon":"webhook","href":"/building-backend-features/webhooks"},{"title":"Connecting a Frontend","icon":"browser","href":"/connecting-to-a-frontend/overview"},{"title":"Metadata API","icon":"brackets-curly","href":"/xano-features/metadata-api"},{"title":"Xano MCP Server","icon":"share-nodes","href":"/ai-tools/xano-mcp-server"}]},{"group":"Security","pages":[{"title":"Best Practices","icon":"shield-check","href":"/security/best-practices"},{"title":"Securing Your App Before Launch","sidebarTitle":"Pre-Launch Security","icon":"list-check","href":"/security/pre-launch-security-checklist"},{"title":"Getting Answers to Security Questions","sidebarTitle":"Security Questionnaires","icon":"clipboard-question","href":"/security/getting-answers-to-security-questions"},{"title":"GDPR","url":"https://security.xano.com/certifications/gdpr","icon":"earth-europe","href":"/security/gdpr"},{"title":"HIPAA","url":"https://security.xano.com/certifications/hipaa","icon":"suitcase-medical","href":"/security/hipaa"},{"title":"SOC 2","url":"https://security.xano.com/certifications/soc-2","icon":"certificate","href":"/security/soc2"},{"title":"security.xano.com","url":"https://security.xano.com","icon":"shield-halved","href":"/security/security"}]},{"group":"Tutorials","pages":[{"group":"Ready-to-use Building Blocks","icon":"cubes","expanded":false,"pages":[{"title":"Snippets","icon":"scissors","href":"/xano-features/snippets"},{"title":"Actions","icon":"block-brick","href":"/xano-actions/what-are-actions"},{"title":"Browse Actions","url":"https://xano.com/actions","href":"/xano-actions/browse-actions"},{"title":"Browse Snippets","url":"https://xano.com/snippet","href":"/browse-snippets"}]},{"group":"Build-along Guides","icon":"graduation-cap","expanded":false,"pages":[{"title":"User Auth \u0026 Data","href":"/building-backend-features/user-authentication-and-user-data"},{"title":"Emails","href":"/building-backend-features/emails"},{"title":"Webhooks","icon":"webhook","href":"/building-backend-features/webhooks"},{"title":"Fuzzy Search","href":"/building-backend-features/fuzzy-search"},{"title":"Messaging","href":"/building-backend-features/messaging"},{"title":"Chatbots","href":"/building-backend-features/chatbots"},{"title":"Custom Report Generation","href":"/building-backend-features/custom-report-generation"}]}]},{"group":"Enterprise","pages":[{"title":"Tenant Center","icon":"building","href":"/enterprise/enterprise-features/tenant-center"},{"title":"Compliance Center","icon":"clipboard-check","href":"/enterprise/enterprise-features/compliance-center"},{"title":"Security Policy","icon":"file-shield","href":"/enterprise/enterprise-features/security-policy"},{"title":"Instance Activity","icon":"chart-line","href":"/enterprise/enterprise-features/instance-activity"},{"title":"Deployment","icon":"rocket-launch","href":"/enterprise/enterprise-features/deployment"},{"title":"RBAC (Role-based Access Control)","icon":"user-shield","href":"/enterprise/enterprise-features/rbac-role-based-access-control"},{"title":"Xano Link","icon":"link","href":"/enterprise/enterprise-features/xano-link"},{"title":"Resource Management","icon":"sliders-up","href":"/enterprise/enterprise-features/resource-management"},{"group":"Microservices","icon":"boxes-stacked","pages":[{"title":"Microservices","sidebarTitle":"Instance Level Microservices","href":"/enterprise/enterprise-features/microservices"},{"group":"In the Workspace","icon":"sitemap","tag":"NEW","pages":[{"title":"Microservices in the Workspace","sidebarTitle":"Overview","icon":"sitemap","href":"/enterprise/enterprise-features/microservices/workspace-microservices"},{"title":"Creating a Microservice","icon":"plus","href":"/enterprise/enterprise-features/microservices/workspace-microservices/creating-a-microservice"},{"title":"Private Registries","icon":"key","href":"/enterprise/enterprise-features/microservices/workspace-microservices/private-registries"},{"title":"Deploying and Monitoring","icon":"chart-line","href":"/enterprise/enterprise-features/microservices/workspace-microservices/deploying-and-monitoring"},{"title":"Calling from the Function Stack","icon":"code","href":"/enterprise/enterprise-features/microservices/workspace-microservices/calling-from-the-function-stack"},{"title":"Releases and Tenants","icon":"building","href":"/enterprise/enterprise-features/microservices/workspace-microservices/releases-and-tenants"},{"title":"XanoScript Reference","icon":"file-code","href":"/enterprise/enterprise-features/microservices/workspace-microservices/xanoscript-reference"}]},{"title":"Ollama","sidebarTitle":"Example: Ollama","href":"/enterprise/enterprise-features/microservices/ollama"}]}]},{"group":"Agencies","pages":[{"title":"Xano For Agencies","icon":"handshake","href":"/agencies/xano-for-agencies"},{"title":"Agency Features","icon":"briefcase","href":"/agencies/agency-features"}]},{"group":"Account and Settings","pages":[{"title":"Workspace Settings","icon":"gear","href":"/xano-features/workspace-settings"},{"title":"Instance Settings","sidebarTitle":"Instance Settings","icon":"server","href":"/xano-features/instance-settings"},{"title":"Account Settings","icon":"circle-user","href":"/your-xano-account/account-page"},{"title":"Billing","icon":"credit-card","href":"/your-xano-account/billing"},{"title":"Getting Help","sidebarTitle":"Getting Support in Xano","icon":"life-ring","href":"/troubleshooting-and-support/getting-help"}]},{"group":"Legal","pages":[{"title":"Terms \u0026 Conditions","icon":"scale-balanced","href":"/legal"},{"title":"AI Terms","icon":"file-contract","href":"/legal/ai-terms"},{"title":"Xano Engine License","icon":"file-contract","href":"/legal/xano-engine-license"},{"title":"Privacy Notice","icon":"lock","href":"/legal/privacy-notice"},{"title":"Cookie Policy","icon":"cookie-bite","href":"/legal/cookie-policy"},{"title":"DMCA Policy","icon":"copyright","href":"/legal/dmca-policy"},{"title":"General Disclaimer","icon":"triangle-exclamation","href":"/legal/general-disclaimer"},{"title":"Subprocessors","icon":"sitemap","href":"/legal/xano-subprocessors"},{"title":"Referral Agreement","icon":"file-signature","href":"/legal/referral-program/agreement"},{"title":"FAQ","icon":"question","href":"/legal/referral-program/faq"}]}]},{"tab":"XanoScript","icon":"code","pages":[{"title":"XanoScript","href":"/xanoscript/introduction"}]},{"tab":"CLI","icon":"terminal","pages":[{"title":"CLI","href":"/xano-cli/get-started"}]},{"tab":"Developer MCP","icon":"robot","pages":[{"title":"Developer MCP","href":"/developer-mcp/get-started"}]},{"tab":"Metadata API","icon":"webhook","pages":[{"title":"Metadata API","href":"/api-reference/audit-logs/search-audit-logs-across-all-workspaces"}]}]},"basePath":"","title":"MCP Builder - Xano Documentation","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js"]}
Xano
