Documentation Index
Fetch the complete documentation index at: https://docs.xano.com/llms.txt
Use this file to discover all available pages before exploring further.
Call AI Agent
Runs an AI agent defined in your Xano workspace. This allows you to invoke an LLM-powered agent, optionally passing arguments and enabling tool execution.
Syntax:
ai.agent.run "Agent Name" {
args = {
prompt: $input.user_query
// ...other arguments
}
allow_tool_execution = true
} as $agent_result
Example:
ai.agent.run "Task Management Agent" {
args = { prompt: $input.task }
allow_tool_execution = true
} as $result
Lists all available tools exposed by an external MCP (Model Context Protocol) server. Use this to discover tool capabilities from a remote MCP endpoint.
Syntax:
ai.external.mcp.tool.list {
mcp_url = "https://external-mcp-server.com"
api_key = $env.mcp_api_key
} as $tool_list
Example:
ai.external.mcp.tool.list {
mcp_url = "https://my-mcp-server.com"
api_key = $env.my_mcp_key
} as $tools
Runs a specific tool on an external MCP server, passing input parameters and receiving the tool’s response.
Syntax:
ai.external.mcp.tool.run {
mcp_url = "https://external-mcp-server.com"
api_key = $env.mcp_api_key
tool_name = "tool-lookup-user"
input = {
user_id: $input.user_id
}
} as $tool_result
Example:
ai.external.mcp.tool.run {
mcp_url = "https://my-mcp-server.com"
api_key = $env.my_mcp_key
tool_name = "get_user_details"
input = { email: $input.email }
} as $user_details
MCP Server Details
Retrieves metadata and configuration details about an external MCP server, such as its available tools, tags, and instructions.
Syntax:
ai.external.mcp.server_details {
mcp_url = "https://external-mcp-server.com"
api_key = $env.mcp_api_key
} as $server_info
Example:
ai.external.mcp.server_details {
mcp_url = "https://my-mcp-server.com"
api_key = $env.my_mcp_key
} as $details
Template Engine
Renders a text or HTML template using the Twig templating engine, allowing for dynamic content generation with variables and logic.
Syntax:
util.template_engine {
value = """
Hello {{ $input.name }},
{% if $input.is_premium %}
Thank you for being a premium member!
{% else %}
Upgrade to premium for more features.
{% endif %}
"""
} as $output
Example:
util.template_engine {
value = """
<h1>Welcome, {{ $input.username }}!</h1>
{% if $input.is_admin %}
<p>You have admin access.</p>
{% else %}
<p>Standard user account.</p>
{% endif %}
"""
} as $html