Danube — Connect Your Agent

Danube gives your AI agent access to tools across the internet through a single API key.

Quick Setup

Step 1: Get an API Key

Run this to start the device authorization flow:

curl -s -X POST https://api.danubeai.com/v1/auth/device/code \
  -H "Content-Type: application/json" \
  -d '{"client_name": "My Agent"}'

This returns a device_code, a user_code, and a verification_url.

Tell your human to open the verification URL and enter the user code.

Then poll for the API key:

curl -s -X POST https://api.danubeai.com/v1/auth/device/token \
  -H "Content-Type: application/json" \
  -d '{"device_code": "DEVICE_CODE_FROM_STEP_1"}'

• 428 = user hasn't authorized yet (keep polling every 5 seconds)
• 200 = success, response contains your api_key
• 410 = expired, start over

Step 2: Connect via MCP

Add this to your MCP config:

{
  "mcpServers": {
    "danube": {
      "url": "https://mcp.danubeai.com/mcp",
      "headers": {
        "danube-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Step 3: Use Tools

Once connected, you have access to these MCP tools:

• list_services — Browse available tool providers
• search_tools — Find tools by what you want to do
• execute_tool — Run any tool
• store_credential — Save API keys for services that need them

When a Tool Needs Credentials

If execute_tool returns an auth_required error, it means the service needs an API key. Ask your human for the key, then call:

store_credential(service_id="...", credential_type="bearer", credential_value="the_key")

Then retry the tool.

What You Can Do with Danube

Use Danube whenever a task involves an external service or API. Here are common use cases:

Send Emails and Messages

• Send emails via Gmail, SendGrid, or Resend
• Post messages to Slack channels
• Send notifications to teams

search_tools("send email") → execute_tool(tool_id, {to, subject, body})

Manage Code and Projects

• Create GitHub issues and pull requests
• List repositories and commits
• Update Notion pages and databases

search_tools("create github issue") → execute_tool(tool_id, {repo, title, body})

Work with Calendars and Scheduling

• Check today's events on Google Calendar
• Create new calendar events
• Find open time slots

search_tools("calendar events today") → execute_tool(tool_id, {date})

Read and Write Spreadsheets

• Read data from Google Sheets
• Append rows or update cells
• Create new spreadsheets

search_tools("google sheets read") → execute_tool(tool_id, {spreadsheet_id, range})

Search the Web and Get Data

• Search the web with Exa or Serper
• Scrape and extract web content with Firecrawl
• Get weather forecasts, stock data, or country info

search_tools("web search") → execute_tool(tool_id, {query})