Get Recommendations

curl -X GET "https://api.danubeai.com/v1/tools/recommended?tool_id=tool_abc123&limit=5" \
  -H "danube-api-key: YOUR_API_KEY"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    recommendations = client.tools.get_recommendations(
        tool_id="tool_abc123",
        limit=5,
    )
    for tool in recommendations:
        print(f"  {tool.name}: {tool.description}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const recommendations = await client.tools.getRecommendations({
  toolId: 'tool_abc123',
  limit: 5,
});
recommendations.forEach(t => console.log(`${t.name}: ${t.description}`));

[
  {
    "id": "tool_def456",
    "name": "Slack - Send Message",
    "description": "Send a message to a Slack channel",
    "service_id": "svc_slack_001"
  },
  {
    "id": "tool_ghi789",
    "name": "Gmail - Send Email",
    "description": "Send an email via Gmail",
    "service_id": "svc_gmail_001"
  }
]

GET

tools

recommended

curl -X GET "https://api.danubeai.com/v1/tools/recommended?tool_id=tool_abc123&limit=5" \
  -H "danube-api-key: YOUR_API_KEY"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    recommendations = client.tools.get_recommendations(
        tool_id="tool_abc123",
        limit=5,
    )
    for tool in recommendations:
        print(f"  {tool.name}: {tool.description}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const recommendations = await client.tools.getRecommendations({
  toolId: 'tool_abc123',
  limit: 5,
});
recommendations.forEach(t => console.log(`${t.name}: ${t.description}`));

[
  {
    "id": "tool_def456",
    "name": "Slack - Send Message",
    "description": "Send a message to a Slack channel",
    "service_id": "svc_slack_001"
  },
  {
    "id": "tool_ghi789",
    "name": "Gmail - Send Email",
    "description": "Send an email via Gmail",
    "service_id": "svc_gmail_001"
  }
]

Overview

Get tool recommendations based on co-usage patterns. Optionally pass a tool_id to find tools frequently used together with it. Without a tool_id, returns popular tools or personalized recommendations. Auth: Optional (works with or without authentication). Authenticated requests may return personalized results.

Query Parameters

tool_id

string

Optional UUID of a tool to find related tools for

limit

integer

default:5

Maximum number of recommendations to return

Response

Returns an array of recommended tool objects.

string

Tool UUID

name

string

Tool name

description

string

Tool description

service_id

string

Parent service UUID

Example

curl -X GET "https://api.danubeai.com/v1/tools/recommended?tool_id=tool_abc123&limit=5" \
  -H "danube-api-key: YOUR_API_KEY"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    recommendations = client.tools.get_recommendations(
        tool_id="tool_abc123",
        limit=5,
    )
    for tool in recommendations:
        print(f"  {tool.name}: {tool.description}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const recommendations = await client.tools.getRecommendations({
  toolId: 'tool_abc123',
  limit: 5,
});
recommendations.forEach(t => console.log(`${t.name}: ${t.description}`));

[
  {
    "id": "tool_def456",
    "name": "Slack - Send Message",
    "description": "Send a message to a Slack channel",
    "service_id": "svc_slack_001"
  },
  {
    "id": "tool_ghi789",
    "name": "Gmail - Send Email",
    "description": "Send an email via Gmail",
    "service_id": "svc_gmail_001"
  }
]

MCP Tool

This endpoint is also available as the get_recommendations MCP tool:

result = await mcp.call_tool("get_recommendations", {
    "tool_id": "tool_abc123",
    "limit": 5
})

Report Tool List Services

​Overview

​Query Parameters

​Response

​Example

​MCP Tool

Overview

Query Parameters

Response

Example

MCP Tool