curl -X GET "https://api.danubeai.com/v1/services/svc_github_001/tools" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
result = client.services.get_tools("svc_github_001")
if result.needs_configuration:
print(f"Connect the service first: {result.configuration_url}")
for tool in result.tools:
print(tool.name)
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const result = await client.services.getTools('svc_github_001');
if (result.needsConfiguration) {
console.log('Connect the service first', result.configurationRequired);
}
for (const t of result.tools) {
console.log(t.name, t.readiness);
}
[
{
"id": "tool_abc123",
"name": "GitHub - List Repository Issues",
"slug": "github-list-repository-issues",
"description": "List issues in a repository",
"tags": ["issues", "repository"],
"base_url": "https://api.github.com",
"path": "/repos/{owner}/{repo}/issues",
"method": "GET",
"version": "1.0.0",
"parameters": {
"owner": {
"name": "owner",
"location": "path",
"description": "Repository owner",
"type": "string",
"required": true
},
"repo": {
"name": "repo",
"location": "path",
"description": "Repository name",
"type": "string",
"required": true
}
},
"output": {},
"security_schemes": {"bearerAuth": []},
"tips": null,
"metadata": {},
"service_id": "svc_github_001",
"created_at": "2026-06-28T09:00:00Z",
"updated_at": "2026-09-10T12:30:00Z",
"is_paid": false,
"x402_enabled": false,
"deprecated": false,
"readiness": "ready",
"configuration_url": null
}
]
Services
Get Service Tools (Authenticated)
The tools of one service for a signed-in caller, with configuration hints when an MCP service is not usable yet
GET
/
v1
/
services
/
{service_id}
/
tools
curl -X GET "https://api.danubeai.com/v1/services/svc_github_001/tools" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
result = client.services.get_tools("svc_github_001")
if result.needs_configuration:
print(f"Connect the service first: {result.configuration_url}")
for tool in result.tools:
print(tool.name)
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const result = await client.services.getTools('svc_github_001');
if (result.needsConfiguration) {
console.log('Connect the service first', result.configurationRequired);
}
for (const t of result.tools) {
console.log(t.name, t.readiness);
}
[
{
"id": "tool_abc123",
"name": "GitHub - List Repository Issues",
"slug": "github-list-repository-issues",
"description": "List issues in a repository",
"tags": ["issues", "repository"],
"base_url": "https://api.github.com",
"path": "/repos/{owner}/{repo}/issues",
"method": "GET",
"version": "1.0.0",
"parameters": {
"owner": {
"name": "owner",
"location": "path",
"description": "Repository owner",
"type": "string",
"required": true
},
"repo": {
"name": "repo",
"location": "path",
"description": "Repository name",
"type": "string",
"required": true
}
},
"output": {},
"security_schemes": {"bearerAuth": []},
"tips": null,
"metadata": {},
"service_id": "svc_github_001",
"created_at": "2026-06-28T09:00:00Z",
"updated_at": "2026-09-10T12:30:00Z",
"is_paid": false,
"x402_enabled": false,
"deprecated": false,
"readiness": "ready",
"configuration_url": null
}
]
Overview
Returns the stored tools of a service, each stamped with yourreadiness. When a service backed by an MCP server has no synced tools yet, the response is an object instead of a list and says what to do next: sync, configure credentials, or complete the server’s own OAuth flow.
Get Service Tools at /v1/services/public/{service_id}/tools needs no auth, lists public services only, and always answers with a list.
Auth: Required. API key (danube-api-key header) or JWT. A private service is visible to its owner only; everyone else gets 404.
Path Parameters
Response
The response has two shapes. Check whether the body is an array before reading it.A list of tools
The common case: a bare JSON array of tool objects in the service’s own order, or an empty array when a service that is not an MCP server has no tools. Each tool hasid, name, slug (when set), description, tags, base_url, path, method, version, parameters, output, security_schemes, tips, metadata, service_id, created_at, updated_at, is_paid, price_per_call_cents (when set), x402_enabled, x402_price_usdc_atomic (when set), deprecated, deprecation_message and sunset_date (when set), plus:
An object, when an MCP service has no tools yet
tools is always [] in this shape. One of three variants is returned:
{
"tools": [],
"needs_sync": true,
"tool_sync": {"status": "running", "started_at": "2026-09-13T21:43:40+00:00"},
"message": "Notion is connected and its tools are being discovered. Read again in a few seconds."
}
tool_sync.status leaves running (it becomes done, with a tools count, or failed, with an error), then the list is returned as usual.
{
"tools": [],
"needs_configuration": true,
"skipped": false,
"configuration_info": {
"service_id": "svc_example_001",
"service_name": "Example",
"message": "Configure credentials for Example to use its tools",
"credential_schema": {"fields": [{"name": "api_key", "type": "string", "required": true}]},
"configuration_url": "/dashboard/services/svc_example_001"
}
}
skipped is always false.
{
"tools": [],
"needs_mcp_oauth": true,
"mcp_oauth_info": {
"service_id": "svc_notion_001",
"service_name": "Notion",
"message": "Notion requires authentication via its own OAuth flow",
"authorization_endpoint": "https://mcp.notion.com/authorize",
"token_endpoint": "https://mcp.notion.com/token",
"registration_endpoint": "https://mcp.notion.com/register",
"scopes_supported": ["mcp:tools"],
"auth_server_url": "https://mcp.notion.com"
}
}
Example
curl -X GET "https://api.danubeai.com/v1/services/svc_github_001/tools" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
result = client.services.get_tools("svc_github_001")
if result.needs_configuration:
print(f"Connect the service first: {result.configuration_url}")
for tool in result.tools:
print(tool.name)
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const result = await client.services.getTools('svc_github_001');
if (result.needsConfiguration) {
console.log('Connect the service first', result.configurationRequired);
}
for (const t of result.tools) {
console.log(t.name, t.readiness);
}
[
{
"id": "tool_abc123",
"name": "GitHub - List Repository Issues",
"slug": "github-list-repository-issues",
"description": "List issues in a repository",
"tags": ["issues", "repository"],
"base_url": "https://api.github.com",
"path": "/repos/{owner}/{repo}/issues",
"method": "GET",
"version": "1.0.0",
"parameters": {
"owner": {
"name": "owner",
"location": "path",
"description": "Repository owner",
"type": "string",
"required": true
},
"repo": {
"name": "repo",
"location": "path",
"description": "Repository name",
"type": "string",
"required": true
}
},
"output": {},
"security_schemes": {"bearerAuth": []},
"tips": null,
"metadata": {},
"service_id": "svc_github_001",
"created_at": "2026-06-28T09:00:00Z",
"updated_at": "2026-09-10T12:30:00Z",
"is_paid": false,
"x402_enabled": false,
"deprecated": false,
"readiness": "ready",
"configuration_url": null
}
]
limit query parameter that this endpoint does not read. The Python SDK cuts the list to limit on the client side; the TypeScript SDK returns the whole list.
MCP Tool
This endpoint is also available as theget_service_tools MCP tool. The MCP tool always answers with an object, and derives needs_configuration from each tool’s readiness:
result = await mcp.call_tool("get_service_tools", {
"service_id": "svc_github_001",
"limit": 50
})
