curl -X GET "https://api.danubeai.com/v1/agents/getting-started"
{ "free_tier": { "calls_per_month": 5000, "note": "No credential and no funding needed for the tools below. Priced tools need wallet balance; connect credentials for tools marked needs_credential." }, "endpoints": { "mcp": "https://mcp.danubeai.com/mcp", "search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true", "describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe", "execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}", "execute_body": "JSON object of the tool's parameters, e.g. {\"limit\": 5}. Wrapping it as {\"tool_input\": {...}} is also accepted. Do not wrap it as {\"parameters\": {...}}.", "auth_header": "danube-api-key: <your key>" }, "try_first": [ { "tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "description": "Get the current top stories with their content.", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085", "example_body": {} } ], "read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"], "steps": [ "Search with ready_only=true to see only tools you can call now.", "Call describe on a tool you have not used before; it returns the schema, readiness and reliability.", "Execute one of try_first; a 200 with status=success is your activation.", "For anything marked needs_credential, send the user to configuration_url or call store_credential." ]}
Agents
Agent Getting Started
What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next
GET
/
v1
/
agents
/
getting-started
curl -X GET "https://api.danubeai.com/v1/agents/getting-started"
{ "free_tier": { "calls_per_month": 5000, "note": "No credential and no funding needed for the tools below. Priced tools need wallet balance; connect credentials for tools marked needs_credential." }, "endpoints": { "mcp": "https://mcp.danubeai.com/mcp", "search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true", "describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe", "execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}", "execute_body": "JSON object of the tool's parameters, e.g. {\"limit\": 5}. Wrapping it as {\"tool_input\": {...}} is also accepted. Do not wrap it as {\"parameters\": {...}}.", "auth_header": "danube-api-key: <your key>" }, "try_first": [ { "tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "description": "Get the current top stories with their content.", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085", "example_body": {} } ], "read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"], "steps": [ "Search with ready_only=true to see only tools you can call now.", "Call describe on a tool you have not used before; it returns the schema, readiness and reliability.", "Execute one of try_first; a 200 with status=success is your activation.", "For anything marked needs_credential, send the user to configuration_url or call store_credential." ]}
Overview
Returns the same getting_started block that Register Agent includes in its response. Fetch it any time: an agent that registered earlier can re-read it, and a human can read along.The free tier allows 5,000 tool calls a month. No credential and no funding are needed for the tools in try_first. Priced tools need wallet balance, and tools marked needs_credential in search need a credential connected by the operator.Auth: none. Rate limited to 30 requests per minute per IP.
Response
object
Show Free tier
integer
Tool calls a month on the free tier
string
What needs funding or credentials
object
Show Endpoints
string
The MCP connection URL
string
Method and URL for tool search, with ready_only=true
string
Method and URL for a tool’s schema, readiness and reliability
string
Method and URL for calling a tool
string
How to shape the call body: the tool’s parameters as a plain JSON object, or wrapped as tool_input. Never wrapped as parameters.
string
The header to send: danube-api-key: <your key>
array
Up to three credential-free tools, one per service.
Show Tool entry
string
Tool UUID
string
Tool name
string
Service name
string
Tool description, cut to 200 characters
object
The tool’s parameter schema, keyed by parameter name
string
Method and URL for calling this tool
object
A fill-in body: every required parameter with its default, its first enum value, or a typed placeholder such as <string>
array
Two URLs: the agent skill file and the quickstart
array
Four sentences on the shortest path to a first success
Example
The Python and TypeScript SDKs do not wrap this endpoint yet.
curl -X GET "https://api.danubeai.com/v1/agents/getting-started"
{ "free_tier": { "calls_per_month": 5000, "note": "No credential and no funding needed for the tools below. Priced tools need wallet balance; connect credentials for tools marked needs_credential." }, "endpoints": { "mcp": "https://mcp.danubeai.com/mcp", "search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true", "describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe", "execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}", "execute_body": "JSON object of the tool's parameters, e.g. {\"limit\": 5}. Wrapping it as {\"tool_input\": {...}} is also accepted. Do not wrap it as {\"parameters\": {...}}.", "auth_header": "danube-api-key: <your key>" }, "try_first": [ { "tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "description": "Get the current top stories with their content.", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085", "example_body": {} } ], "read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"], "steps": [ "Search with ready_only=true to see only tools you can call now.", "Call describe on a tool you have not used before; it returns the schema, readiness and reliability.", "Execute one of try_first; a 200 with status=success is your activation.", "For anything marked needs_credential, send the user to configuration_url or call store_credential." ]}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Danube","colors":{"primary":"#177EBC","light":"#177EBC","dark":"#177EBC"},"logo":{"light":"https://mintcdn.com/danube/rODiJlJdIDqSBKXh/images/hero.png?fit=max\u0026auto=format\u0026n=rODiJlJdIDqSBKXh\u0026q=85\u0026s=f4cba3d80e8c521e27273c4e245cfea4","dark":"https://mintcdn.com/danube/rODiJlJdIDqSBKXh/images/hero.png?fit=max\u0026auto=format\u0026n=rODiJlJdIDqSBKXh\u0026q=85\u0026s=f4cba3d80e8c521e27273c4e245cfea4","href":"https://danubeai.com"},"favicon":"https://mintcdn.com/danube/rODiJlJdIDqSBKXh/Danube_icon.png?fit=max\u0026auto=format\u0026n=rODiJlJdIDqSBKXh\u0026q=85\u0026s=946a64b7cd661838d30c71564a63532e","navbar":{"links":[{"href":"mailto:support@danubeai.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://danubeai.com/dashboard"}},"footer":{"socials":{"x":"https://x.com/danubeai","linkedin":"https://linkedin.com/company/danubeai"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://danubeai.com/dashboard"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"danube","hasAudioNarration":false,"actualSubdomain":"danube","customDomains":["docs.danubeai.com"],"gitSource":{"type":"github","owner":"danubeai","repo":"danube","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae73266039e90b0fea205c4","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Documentation","count":60},{"language":"default","tag":"Infrastructure Connectors","count":19},{"language":"default","tag":"Tools","count":12},{"language":"default","tag":"SDKs \u0026 Integrations","count":11},{"language":"default","tag":"Skills","count":9},{"language":"default","tag":"Organizations \u0026 Governance","count":9},{"language":"default","tag":"Workflows","count":8},{"language":"default","tag":"Services","count":8},{"language":"default","tag":"MCP Clients","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/endpoint/agent_getting_started","slug":"/api-reference/endpoint/agent_getting_started","pageMetadata":{"title":"Agent Getting Started","api":"GET /v1/agents/getting-started","description":"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next","href":"/api-reference/endpoint/agent_getting_started"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Expandable,Heading,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Returns the same `,_jsx(_components.code,{children:`getting_started`}),` block that `,_jsx(_components.a,{href:`/api-reference/endpoint/register_agent`,children:`Register Agent`}),` includes in its response. Fetch it any time: an agent that registered earlier can re-read it, and a human can read along.`]}),`\n`,_jsxs(_components.p,{children:[`The free tier allows 5,000 tool calls a month. No credential and no funding are needed for the tools in `,_jsx(_components.code,{children:`try_first`}),`. Priced tools need wallet balance, and tools marked `,_jsx(_components.code,{children:`needs_credential`}),` in search need a credential connected by the operator.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Auth:`}),` none. Rate limited to 30 requests per minute per IP.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`free_tier`,type:`object`,id:`param-free-tier`,children:_jsxs(Expandable,{title:`Free tier`,children:[_jsx(ResponseField,{name:`calls_per_month`,type:`integer`,id:`param-calls-per-month`,children:`Tool calls a month on the free tier`}),_jsx(ResponseField,{name:`note`,type:`string`,id:`param-note`,children:`What needs funding or credentials`})]})}),`\n`,_jsx(ResponseField,{name:`endpoints`,type:`object`,id:`param-endpoints`,children:_jsxs(Expandable,{title:`Endpoints`,children:[_jsx(ResponseField,{name:`mcp`,type:`string`,id:`param-mcp`,children:`The MCP connection URL`}),_jsxs(ResponseField,{name:`search`,type:`string`,id:`param-search`,children:[`Method and URL for tool search, with `,_jsx(_components.code,{children:`ready_only=true`})]}),_jsx(ResponseField,{name:`describe`,type:`string`,id:`param-describe`,children:`Method and URL for a tool’s schema, readiness and reliability`}),_jsx(ResponseField,{name:`execute`,type:`string`,id:`param-execute`,children:`Method and URL for calling a tool`}),_jsxs(ResponseField,{name:`execute_body`,type:`string`,id:`param-execute-body`,children:[`How to shape the call body: the tool’s parameters as a plain JSON object, or wrapped as `,_jsx(_components.code,{children:`tool_input`}),`. Never wrapped as `,_jsx(_components.code,{children:`parameters`}),`.`]}),_jsxs(ResponseField,{name:`auth_header`,type:`string`,id:`param-auth-header`,children:[`The header to send: `,_jsx(_components.code,{children:`danube-api-key: \u003cyour key>`})]})]})}),`\n`,_jsxs(ResponseField,{name:`try_first`,type:`array`,id:`param-try-first`,children:[_jsx(_components.p,{children:`Up to three credential-free tools, one per service.`}),_jsxs(Expandable,{title:`Tool entry`,children:[_jsx(ResponseField,{name:`tool_id`,type:`string`,id:`param-tool-id`,children:`Tool UUID`}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:`Tool name`}),_jsx(ResponseField,{name:`service`,type:`string`,id:`param-service`,children:`Service name`}),_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description`,children:`Tool description, cut to 200 characters`}),_jsx(ResponseField,{name:`parameters`,type:`object`,id:`param-parameters`,children:`The tool’s parameter schema, keyed by parameter name`}),_jsx(ResponseField,{name:`execute`,type:`string`,id:`param-execute-1`,children:`Method and URL for calling this tool`}),_jsxs(ResponseField,{name:`example_body`,type:`object`,id:`param-example-body`,children:[`A fill-in body: every required parameter with its default, its first enum value, or a typed placeholder such as `,_jsx(_components.code,{children:`\u003cstring>`})]})]})]}),`\n`,_jsx(ResponseField,{name:`read_next`,type:`array`,id:`param-read-next`,children:`Two URLs: the agent skill file and the quickstart`}),`\n`,_jsx(ResponseField,{name:`steps`,type:`array`,id:`param-steps`,children:`Four sentences on the shortest path to a first success`}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(_components.p,{children:`The Python and TypeScript SDKs do not wrap this endpoint yet.`})]})}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":"Agent Getting Started","api":"GET /v1/agents/getting-started","description":"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next","href":"/api-reference/endpoint/agent_getting_started"}}},"mdxSourceWithNoJs":{"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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Returns the same `,_jsx(_components.code,{children:`getting_started`}),` block that `,_jsx(_components.a,{href:`/api-reference/endpoint/register_agent`,children:`Register Agent`}),` includes in its response. Fetch it any time: an agent that registered earlier can re-read it, and a human can read along.`]}),`\n`,_jsxs(_components.p,{children:[`The free tier allows 5,000 tool calls a month. No credential and no funding are needed for the tools in `,_jsx(_components.code,{children:`try_first`}),`. Priced tools need wallet balance, and tools marked `,_jsx(_components.code,{children:`needs_credential`}),` in search need a credential connected by the operator.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Auth:`}),` none. Rate limited to 30 requests per minute per IP.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`free_tier`,type:`object`,id:`param-free-tier`,children:_jsxs(Expandable,{title:`Free tier`,children:[_jsx(ResponseField,{name:`calls_per_month`,type:`integer`,id:`param-calls-per-month`,children:`Tool calls a month on the free tier`}),_jsx(ResponseField,{name:`note`,type:`string`,id:`param-note`,children:`What needs funding or credentials`})]})}),`\n`,_jsx(ResponseField,{name:`endpoints`,type:`object`,id:`param-endpoints`,children:_jsxs(Expandable,{title:`Endpoints`,children:[_jsx(ResponseField,{name:`mcp`,type:`string`,id:`param-mcp`,children:`The MCP connection URL`}),_jsxs(ResponseField,{name:`search`,type:`string`,id:`param-search`,children:[`Method and URL for tool search, with `,_jsx(_components.code,{children:`ready_only=true`})]}),_jsx(ResponseField,{name:`describe`,type:`string`,id:`param-describe`,children:`Method and URL for a tool’s schema, readiness and reliability`}),_jsx(ResponseField,{name:`execute`,type:`string`,id:`param-execute`,children:`Method and URL for calling a tool`}),_jsxs(ResponseField,{name:`execute_body`,type:`string`,id:`param-execute-body`,children:[`How to shape the call body: the tool’s parameters as a plain JSON object, or wrapped as `,_jsx(_components.code,{children:`tool_input`}),`. Never wrapped as `,_jsx(_components.code,{children:`parameters`}),`.`]}),_jsxs(ResponseField,{name:`auth_header`,type:`string`,id:`param-auth-header`,children:[`The header to send: `,_jsx(_components.code,{children:`danube-api-key: \u003cyour key>`})]})]})}),`\n`,_jsxs(ResponseField,{name:`try_first`,type:`array`,id:`param-try-first`,children:[_jsx(_components.p,{children:`Up to three credential-free tools, one per service.`}),_jsxs(Expandable,{title:`Tool entry`,children:[_jsx(ResponseField,{name:`tool_id`,type:`string`,id:`param-tool-id`,children:`Tool UUID`}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:`Tool name`}),_jsx(ResponseField,{name:`service`,type:`string`,id:`param-service`,children:`Service name`}),_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description`,children:`Tool description, cut to 200 characters`}),_jsx(ResponseField,{name:`parameters`,type:`object`,id:`param-parameters`,children:`The tool’s parameter schema, keyed by parameter name`}),_jsx(ResponseField,{name:`execute`,type:`string`,id:`param-execute-1`,children:`Method and URL for calling this tool`}),_jsxs(ResponseField,{name:`example_body`,type:`object`,id:`param-example-body`,children:[`A fill-in body: every required parameter with its default, its first enum value, or a typed placeholder such as `,_jsx(_components.code,{children:`\u003cstring>`})]})]})]}),`\n`,_jsx(ResponseField,{name:`read_next`,type:`array`,id:`param-read-next`,children:`Two URLs: the agent skill file and the quickstart`}),`\n`,_jsx(ResponseField,{name:`steps`,type:`array`,id:`param-steps`,children:`Four sentences on the shortest path to a first success`}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(_components.p,{children:`The Python and TypeScript SDKs do not wrap this endpoint yet.`}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X GET `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.danubeai.com/v1/agents/getting-started\"`})]}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`32`,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:`32`,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:` \"free_tier\"`}),_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:` \"calls_per_month\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5000`}),_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:` \"note\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"No credential and no funding needed for the tools below. Priced tools need wallet balance; connect credentials for tools marked needs_credential.\"`})]}),`\n`,_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:` \"endpoints\"`}),_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:` \"mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://mcp.danubeai.com/mcp\"`}),_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:` \"search\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GET https://api.danubeai.com/v1/tools/search?query=...\u0026ready_only=true\"`}),_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:` \"describe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GET https://api.danubeai.com/v1/tools/{tool_id}/describe\"`}),_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:` \"execute\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST https://api.danubeai.com/v1/tools/call/{tool_id}\"`}),_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:` \"execute_body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"JSON object of the tool's parameters, e.g. {`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`limit`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: 5}. Wrapping it as {`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`tool_input`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: {...}} is also accepted. Do not wrap it as {`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`parameters`}),_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:` \"auth_header\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"danube-api-key: \u003cyour key>\"`})]}),`\n`,_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:` \"try_first\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tool_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"8ca97ef7-acf5-4869-b043-a9960a9f8085\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hacker News - Get Top Stories With Content\"`}),_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:` \"service\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hacker News\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Get the current top stories with their content.\"`}),_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:` \"parameters\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"limit\"`}),_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:`\"integer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"execute\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085\"`}),_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:` \"example_body\"`}),_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`,_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:` \"read_next\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://danubeai.com/skill.md\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://docs.danubeai.com/quickstart\"`}),_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:` \"steps\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Search with ready_only=true to see only tools you can call now.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Call describe on a tool you have not used before; it returns the schema, readiness and reliability.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Execute one of try_first; a 200 with status=success is your activation.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"For anything marked needs_credential, send the user to configuration_url or call store_credential.\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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`]})})})})]})}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":"Agent Getting Started","api":"GET /v1/agents/getting-started","description":"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next","href":"/api-reference/endpoint/agent_getting_started"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"1\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -X GET \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.danubeai.com/v1/agents/getting-started\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"32\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"free_tier\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"calls_per_month\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">5000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"note\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"No credential and no funding needed for the tools below. Priced tools need wallet balance; connect credentials for tools marked needs_credential.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"endpoints\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"mcp\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://mcp.danubeai.com/mcp\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"search\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"GET https://api.danubeai.com/v1/tools/search?query=...\u0026#x26;ready_only=true\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"describe\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"GET https://api.danubeai.com/v1/tools/{tool_id}/describe\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"execute\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"POST https://api.danubeai.com/v1/tools/call/{tool_id}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"execute_body\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"JSON object of the tool's parameters, e.g. {\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\">\\\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">limit\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\">\\\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: 5}. Wrapping it as {\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\">\\\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">tool_input\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\">\\\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: {...}} is also accepted. Do not wrap it as {\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\">\\\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">parameters\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\">\\\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: {...}}.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"auth_header\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"danube-api-key: \u0026#x3C;your key>\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"try_first\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tool_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"8ca97ef7-acf5-4869-b043-a9960a9f8085\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Hacker News - Get Top Stories With Content\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"service\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Hacker News\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Get the current top stories with their content.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"parameters\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"limit\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"integer\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"required\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"execute\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"example_body\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"read_next\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://danubeai.com/skill.md\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://docs.danubeai.com/quickstart\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"steps\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Search with ready_only=true to see only tools you can call now.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Call describe on a tool you have not used before; it returns the schema, readiness and reliability.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Execute one of try_first; a 200 with status=success is your activation.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"For anything marked needs_credential, send the user to configuration_url or call store_credential.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Agent Getting Started","path":"/v1/agents/getting-started","method":"get","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"free_tier":[{"type":"object","properties":{"calls_per_month":[{"type":"integer","description":"Tool calls a month on the free tier"}],"note":[{"type":"string","description":"What needs funding or credentials"}]}}],"endpoints":[{"type":"object","properties":{"mcp":[{"type":"string","description":"The MCP connection URL"}],"search":[{"type":"string","description":"Method and URL for tool search, with `ready_only=true`"}],"describe":[{"type":"string","description":"Method and URL for a tool’s schema, readiness and reliability"}],"execute":[{"type":"string","description":"Method and URL for calling a tool"}],"execute_body":[{"type":"string","description":"How to shape the call body: the tool’s parameters as a plain JSON object, or wrapped as `tool_input` . Never wrapped as `parameters` ."}],"auth_header":[{"type":"string","description":"The header to send: `danube-api-key: \u003cyour key>`"}]}}],"try_first":[{"type":"array","items":[{"type":"object","properties":{"tool_id":[{"type":"string","description":"Tool UUID"}],"name":[{"type":"string","description":"Tool name"}],"service":[{"type":"string","description":"Service name"}],"description":[{"type":"string","description":"Tool description, cut to 200 characters"}],"parameters":[{"type":"object","properties":{},"description":"The tool’s parameter schema, keyed by parameter name"}],"execute":[{"type":"string","description":"Method and URL for calling this tool"}],"example_body":[{"type":"object","properties":{},"description":"A fill-in body: every required parameter with its default, its first enum value, or a typed placeholder such as `\u003cstring>`"}]}}],"description":"Up to three credential-free tools, one per service."}],"read_next":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Two URLs: the agent skill file and the quickstart"}],"steps":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Four sentences on the shortest path to a first success"}]}}],"examples":{"example":{"value":{"free_tier":{"calls_per_month":123,"note":"\u003cstring>"},"endpoints":{"mcp":"\u003cstring>","search":"\u003cstring>","describe":"\u003cstring>","execute":"\u003cstring>","execute_body":"\u003cstring>","auth_header":"\u003cstring>"},"try_first":[{"tool_id":"\u003cstring>","name":"\u003cstring>","service":"\u003cstring>","description":"\u003cstring>","parameters":{},"execute":"\u003cstring>","example_body":{}}],"read_next":[{}],"steps":[{}]}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"danube","siteName":"Danube","title":"Agent Getting Started - Danube","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-12T17:31:58.132Z","originalFileLocation":"api-reference/endpoint/agent_getting_started.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next\">\u003cmeta data-mint-head name=\"application-name\" content=\"Danube\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_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/danube/Uwuo-iO2_Nq0x2cb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent Getting Started - Danube\">\u003cmeta data-mint-head property=\"og:description\" content=\"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Danube\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://danube.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Agent+Getting+Started\u0026amp;description=What+a+new+agent+needs+for+a+first+successful+call%3A+endpoints%2C+the+free+tier%2C+tools+to+try%2C+what+to+read+next\u0026amp;theme=aecfda775d536aadf2ecc319\u0026amp;signature=5ab025359116b0cacbe0c824ca46a8b5ba43c4dfbe89b56a44fb712ce195488b\">\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=\"Agent Getting Started - Danube\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://danube.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Agent+Getting+Started\u0026amp;description=What+a+new+agent+needs+for+a+first+successful+call%3A+endpoints%2C+the+free+tier%2C+tools+to+try%2C+what+to+read+next\u0026amp;theme=aecfda775d536aadf2ecc319\u0026amp;signature=5ab025359116b0cacbe0c824ca46a8b5ba43c4dfbe89b56a44fb712ce195488b\">\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/danube/Uwuo-iO2_Nq0x2cb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Danube\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#177EBC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/agent_getting_started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.danubeai.com/#organization\",\"name\":\"Danube\",\"url\":\"https://docs.danubeai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/danube/rODiJlJdIDqSBKXh/images/hero.png?fit=max\u0026auto=format\u0026n=rODiJlJdIDqSBKXh\u0026q=85\u0026s=f4cba3d80e8c521e27273c4e245cfea4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.danubeai.com#website\",\"name\":\"Danube\",\"url\":\"https://docs.danubeai.com\",\"publisher\":{\"@id\":\"https://docs.danubeai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started#webpage\",\"url\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started\",\"name\":\"Agent Getting Started\",\"description\":\"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next\",\"dateModified\":\"2026-09-12T17:31:58.132Z\",\"isPartOf\":{\"@id\":\"https://docs.danubeai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.danubeai.com/api-reference/endpoint/register_agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent Getting Started\",\"item\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started#apireference\",\"headline\":\"Agent Getting Started\",\"name\":\"Agent Getting Started\",\"description\":\"What a new agent needs for a first successful call: endpoints, the free tier, tools to try, what to read next\",\"url\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started\",\"mainEntityOfPage\":{\"@id\":\"https://docs.danubeai.com/api-reference/endpoint/agent_getting_started#webpage\"},\"dateModified\":\"2026-09-12T17:31:58.132Z\",\"publisher\":{\"@id\":\"https://docs.danubeai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.danubeai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Danube\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Danube\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/agent_getting_started.md","siteName":"Danube","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://danubeai.com/dashboard"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Tools","pages":[{"title":"List Tools","openapi":"GET /tools","href":"/api-reference/endpoint/list_tools"},{"title":"Search Tools","openapi":"GET /tools/search","href":"/api-reference/endpoint/search_tools"},{"title":"Get Tool by ID","openapi":"GET /tools/{tool_id}","href":"/api-reference/endpoint/get_tool"},{"title":"Get Tool by Name","openapi":"GET /tools/name/{tool_name}","href":"/api-reference/endpoint/get_tool_by_name"},{"title":"Call Tool","openapi":"POST /tools/call/{tool_id}","href":"/api-reference/endpoint/call_tools"},{"title":"Batch Call Tools","api":"POST /v1/tools/call/batch","href":"/api-reference/endpoint/batch_call_tools"},{"title":"Report Tool","api":"POST /v1/tools/{tool_id}/report","href":"/api-reference/endpoint/report_tool"},{"title":"Get Recommendations","api":"GET /v1/tools/recommended","href":"/api-reference/endpoint/get_recommendations"},{"title":"Describe Tool","api":"GET /v1/tools/{tool_id}/describe","href":"/api-reference/endpoint/describe_tool"},{"title":"Get Execution Result","api":"GET /v1/tools/executions/{execution_id}/result","href":"/api-reference/endpoint/get_execution_result"},{"title":"Public Search Tools","api":"GET /v1/tools/public/search","href":"/api-reference/endpoint/public_search_tools"},{"title":"Try Public Tool","api":"POST /v1/tools/public/{tool_id}/try","href":"/api-reference/endpoint/try_public_tool"}]},{"group":"Services","pages":[{"title":"List Services","openapi":"GET /services/public","href":"/api-reference/endpoint/list_services"},{"title":"Get Service","openapi":"GET /services/public/{service_id}","href":"/api-reference/endpoint/get_service"},{"title":"Get Service Tools","openapi":"GET /services/public/{service_id}/tools","href":"/api-reference/endpoint/get_service_tools"},{"title":"List Services (Authenticated)","api":"GET /v1/services","href":"/api-reference/endpoint/list_my_services"},{"title":"Get Service Tools (Authenticated)","api":"GET /v1/services/{service_id}/tools","href":"/api-reference/endpoint/list_service_tools_authed"},{"title":"Get Parameter Defaults","api":"GET /v1/services/{service_id}/parameter-defaults","href":"/api-reference/endpoint/get_parameter_defaults"},{"title":"Set Parameter Defaults","api":"PUT /v1/services/{service_id}/parameter-defaults","href":"/api-reference/endpoint/set_parameter_defaults"},{"title":"Delete Parameter Defaults","api":"DELETE /v1/services/{service_id}/parameter-defaults","href":"/api-reference/endpoint/delete_parameter_defaults"}]},{"group":"Skills","pages":[{"title":"List Skills","api":"GET /v1/skills","href":"/api-reference/endpoint/list_skills"},{"title":"Search Skills","api":"GET /v1/skills/search","href":"/api-reference/endpoint/search_skills"},{"title":"Get Skill","api":"GET /v1/skills/{skill_id}","href":"/api-reference/endpoint/get_skill"},{"title":"Create Skill","api":"POST /v1/skills","href":"/api-reference/endpoint/create_skill"},{"title":"Update Skill","api":"PATCH /v1/skills/{skill_id}","href":"/api-reference/endpoint/update_skill"},{"title":"Delete Skill","api":"DELETE /v1/skills/{skill_id}","href":"/api-reference/endpoint/delete_skill"},{"title":"List My Skills","api":"GET /v1/skills/my","href":"/api-reference/endpoint/list_my_skills"},{"title":"List Service Skills","api":"GET /v1/skills/service/{service_id}","href":"/api-reference/endpoint/list_service_skills"},{"title":"Validate Skill","api":"POST /v1/skills/validate","href":"/api-reference/endpoint/validate_skill"}]},{"group":"Skill Submissions","pages":[{"title":"Submit Skill for Review","api":"POST /v1/skill-submissions","href":"/api-reference/endpoint/submit_skill"},{"title":"List My Skill Submissions","api":"GET /v1/skill-submissions/my","href":"/api-reference/endpoint/list_my_skill_submissions"},{"title":"Get Skill Submission","api":"GET /v1/skill-submissions/{submission_id}","href":"/api-reference/endpoint/get_skill_submission"},{"title":"Cancel Skill Submission","api":"DELETE /v1/skill-submissions/{submission_id}","href":"/api-reference/endpoint/cancel_skill_submission"}]},{"group":"Workflows","pages":[{"title":"List Public Workflows","api":"GET /v1/workflows/public","href":"/api-reference/endpoint/list_public_workflows"},{"title":"List My Workflows","api":"GET /v1/workflows/my","href":"/api-reference/endpoint/list_my_workflows"},{"title":"Create Workflow","api":"POST /v1/workflows","href":"/api-reference/endpoint/create_workflow"},{"title":"Get Workflow","api":"GET /v1/workflows/{workflow_id}","href":"/api-reference/endpoint/get_workflow"},{"title":"Update Workflow","api":"PATCH /v1/workflows/{workflow_id}","href":"/api-reference/endpoint/update_workflow"},{"title":"Delete Workflow","api":"DELETE /v1/workflows/{workflow_id}","href":"/api-reference/endpoint/delete_workflow"},{"title":"Execute Workflow","api":"POST /v1/workflows/{workflow_id}/execute","href":"/api-reference/endpoint/execute_workflow"},{"title":"Get Workflow Execution","api":"GET /v1/workflows/executions/{execution_id}","href":"/api-reference/endpoint/get_workflow_execution"}]},{"group":"Ratings","pages":[{"title":"Get Tool Ratings","api":"GET /v1/ratings/tool/{tool_id}","href":"/api-reference/endpoint/get_tool_ratings"},{"title":"Submit Rating","api":"POST /v1/ratings","href":"/api-reference/endpoint/submit_rating"},{"title":"Get My Rating","api":"GET /v1/ratings/my/{tool_id}","href":"/api-reference/endpoint/get_my_rating"}]},{"group":"Wallet","pages":[{"title":"Get Wallet Balance","api":"GET /v1/wallet/balance","href":"/api-reference/endpoint/get_wallet_balance"},{"title":"Get Spending Limits","api":"GET /v1/x402/settings","href":"/api-reference/endpoint/get_spending_limits"},{"title":"Update Spending Limits","api":"PUT /v1/x402/settings","href":"/api-reference/endpoint/update_spending_limits"},{"title":"Get Wallet Transactions","api":"GET /v1/wallet/transactions","href":"/api-reference/endpoint/get_wallet_transactions"}]},{"group":"Credentials","pages":[{"title":"Store Credential","api":"POST /v1/credentials/store","href":"/api-reference/endpoint/store_credential"}]},{"group":"Context","pages":[{"title":"Get Context","api":"GET /v1/context","href":"/api-reference/endpoint/get_context"},{"title":"Upsert Personal Context","api":"POST /v1/context/personal/upsert","href":"/api-reference/endpoint/upsert_personal_context"}]},{"group":"API Keys","pages":[{"title":"List API Keys","api":"GET /v1/api-keys","href":"/api-reference/endpoint/list_api_keys"},{"title":"Create API Key","api":"POST /v1/api-keys","href":"/api-reference/endpoint/create_api_key"},{"title":"Rotate API Key","api":"POST /v1/api-keys/{key_id}/rotate","href":"/api-reference/endpoint/rotate_api_key"},{"title":"Update API Key","api":"PATCH /v1/api-keys/{key_id}","href":"/api-reference/endpoint/update_api_key"},{"title":"Get API Key Usage","api":"GET /v1/api-keys/{key_id}/usage","href":"/api-reference/endpoint/get_api_key_usage"},{"title":"Revoke API Key","api":"DELETE /v1/api-keys/{key_id}","href":"/api-reference/endpoint/revoke_api_key"}]},{"group":"Agents","pages":[{"title":"Register Agent","api":"POST /v1/agents","description":"Self-register an autonomous agent and receive an API key, a wallet, and a getting-started block","href":"/api-reference/endpoint/register_agent"},{"title":"Agent Getting Started","api":"GET /v1/agents/getting-started","href":"/api-reference/endpoint/agent_getting_started"},{"title":"Get Agent Info","api":"GET /v1/agents/me","description":"Get the calling agent profile, its USDC wallet balance and its deposit address","href":"/api-reference/endpoint/get_agent_me"},{"title":"Fund Agent Wallet","api":"POST /v1/agents/wallets/fund","href":"/api-reference/endpoint/fund_agent_wallet"}]},{"group":"Webhooks","pages":[{"title":"List Webhooks","api":"GET /v1/webhooks","href":"/api-reference/endpoint/list_webhooks"},{"title":"Create Webhook","api":"POST /v1/webhooks","href":"/api-reference/endpoint/create_webhook"},{"title":"Update Webhook","api":"PATCH /v1/webhooks/{webhook_id}","href":"/api-reference/endpoint/update_webhook"},{"title":"Delete Webhook","api":"DELETE /v1/webhooks/{webhook_id}","href":"/api-reference/endpoint/delete_webhook"},{"title":"Get Webhook Deliveries","api":"GET /v1/webhooks/{webhook_id}/deliveries","href":"/api-reference/endpoint/get_webhook_deliveries"}]},{"group":"Device Auth","pages":[{"title":"Create Device Code","api":"POST /v1/auth/device/code","href":"/api-reference/endpoint/create_device_code"},{"title":"Poll Device Token","api":"POST /v1/auth/device/token","href":"/api-reference/endpoint/poll_device_token"}]},{"group":"Claude Code","pages":[{"title":"Get MCP JSON","api":"GET /v1/claude-code/mcp-json","href":"/api-reference/endpoint/claude_code_mcp_json"},{"title":"Get Org Skill","api":"GET /v1/claude-code/skill","href":"/api-reference/endpoint/claude_code_skill"},{"title":"Get Org Context","api":"GET /v1/claude-code/org-context","href":"/api-reference/endpoint/claude_code_org_context"}]}]}]},"basePath":"","title":"Agent Getting Started - Danube","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}