Danube — Connect Your Agent

Danube gives your AI agent access to 100+ services and 21 tools 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 21 MCP tools:

Discovery

list_services(query, limit) — Browse available tool providers
search_tools(query, service_id, limit) — Find tools by what you want to do (semantic search)
get_service_tools(service_id, limit) — Get all tools for a specific service

Execution

execute_tool(tool_id, tool_name, parameters) — Run any tool by ID or name
batch_execute_tools(calls) — Run up to 10 tools concurrently in one request

Credentials & Wallet

store_credential(service_id, credential_type, credential_value) — Save API keys for services that need them
get_wallet_balance() — Check your credit balance before running paid tools

Skills

search_skills(query, limit) — Find reusable agent skills (instructions, scripts, templates)
get_skill(skill_id, skill_name) — Get full skill content by ID or name

Workflows

list_workflows(query, limit) — Browse public multi-tool workflows
create_workflow(name, steps, description, visibility, tags) — Create a new workflow
execute_workflow(workflow_id, inputs) — Run a multi-tool workflow
get_workflow_execution(execution_id) — Check workflow execution results

Agent Web Directory

search_sites(query, category, limit) — Search the agent-friendly site directory
get_site_info(domain) — Get structured info about a website (pricing, docs, contact, FAQ, etc.)

Agent Management

register_agent(name, operator_email) — Register a new autonomous agent with API key and wallet
get_agent_info() — Get the current agent's profile and wallet balance
fund_agent_wallet(method, amount_cents) — Fund wallet via card checkout or USDC

Tool Quality

submit_rating(tool_id, rating, comment) — Rate a tool 1-5 stars
report_tool(tool_id, reason, description) — Report a broken or degraded tool
get_recommendations(tool_id, limit) — Get tool recommendations based on co-usage patterns

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})

Generate and Process Media

Generate images with Replicate or Stability AI
Transcribe audio with AssemblyAI
Remove image backgrounds with Remove.bg
Translate text with DeepL

search_tools("generate image") → execute_tool(tool_id, {prompt})

Manage Infrastructure

Provision DigitalOcean droplets and databases
Manage Supabase projects
Handle Stripe payments and subscriptions

search_tools("create droplet") → execute_tool(tool_id, {name, region, size})

Run Multi-Tool Workflows

Chain multiple tools together into reusable workflows that pass data between steps automatically.

# Find existing workflows
list_workflows(query="github to slack") → browse available workflows

# Execute a workflow with inputs
execute_workflow(workflow_id="...", inputs={"repo": "my-org/my-repo", "channel": "#dev"})

# Check execution results
get_workflow_execution(execution_id="...")

# Create your own workflow
create_workflow(
  name="Daily Digest",
  steps=[
    {"step_number": 1, "tool_id": "...", "input_mapping": {"repo": "{{inputs.repo}}"}},
    {"step_number": 2, "tool_id": "...", "input_mapping": {"text": "{{steps.1.result}}", "channel": "{{inputs.channel}}"}}
  ],
  tags=["digest", "github", "slack"]
)

Execute Tools in Batch

Run multiple independent tool calls concurrently for faster results.

batch_execute_tools(calls=[
  {"tool_id": "tool-uuid-1", "tool_input": {"query": "AI news"}},
  {"tool_id": "tool-uuid-2", "tool_input": {"query": "tech stocks"}},
  {"tool_id": "tool-uuid-3", "tool_input": {"location": "San Francisco"}}
])

Each call returns independently — individual failures don't fail the batch.

Browse the Agent Web Directory

Search and read structured information about any website in the directory.

# Find sites by topic
search_sites(query="payment processing", category="saas")

# Get structured data about a specific domain
get_site_info(domain="stripe.com")
→ Returns: identity, products, team, pricing, docs, FAQ, contact info, and more

Rate and Report Tools

Help improve tool quality by providing feedback.

# Rate a tool after using it
submit_rating(tool_id="...", rating=5, comment="Fast and accurate")

# Report a broken tool
report_tool(tool_id="...", reason="broken", description="Returns 500 error on all requests")

# Get recommendations for related tools
get_recommendations(tool_id="...", limit=5)

Register and Fund Autonomous Agents

Create standalone agent identities with their own API keys and wallets.

# Register a new agent (no auth required)
register_agent(name="my-research-bot", operator_email="[email protected]")
→ Returns: agent_id, api_key (save this!), wallet_id

# Check agent profile and balance
get_agent_info()

# Fund the agent's wallet
fund_agent_wallet(method="card_checkout", amount_cents=1000)  # $10.00
fund_agent_wallet(method="crypto")  # Returns USDC deposit address on Base

Core Workflow

Every tool interaction follows this pattern:

Search — search_tools("what you want to do")
Check auth — If the tool needs credentials, use store_credential or guide the user to https://danubeai.com/dashboard
Gather parameters — Ask the user for any missing required info
Confirm — Get user approval before executing actions like sending emails or creating issues
Execute — execute_tool(tool_id, parameters)
Report — Tell the user what happened with specifics, not just "Done"

Available Services

Communication: Gmail, Slack, SendGrid, Resend, Loops, AgentMail, Postmark

Development: GitHub, Supabase, DigitalOcean, Stripe, Apify, Netlify, Render, Vercel, Railway, Neon, PlanetScale, Fly.io, Cloudflare Workers, Sentry

Productivity: Notion, Google Calendar, Google Sheets, Google Drive, Google Docs, Monday, Typeform, Bitly, Airtable, Todoist, Linear, Asana, Trello, ClickUp, Jira, Calendly

Cloud & Infrastructure: AWS (S3, Lambda, EC2), Google Cloud, Azure, Cloudflare, Heroku, Terraform

AI & Media: Replicate, Together AI, Stability AI, AssemblyAI, Remove.bg, DeepL, ElevenLabs, Whisper, Midjourney, DALL-E, Claude, OpenAI

Search & Data: Exa, Exa Websets, Firecrawl, Serper, Context7, Microsoft Learn, AlphaVantage, Clearbit, Hunter.io, Crunchbase, Diffbot

Finance: Stripe, Plaid, Wise, Coinbase, PayPal, Square, QuickBooks

Social: Twitter/X, LinkedIn, Discord, Reddit, Mastodon, Instagram, YouTube

Design & Analytics: Figma, Canva, Mixpanel, Amplitude, Segment, PostHog, Google Analytics

Maps & Geo: Google Maps, Mapbox, OpenStreetMap

Weather: Open-Meteo, OpenWeather, WeatherAPI, Tomorrow.io

Public Data (No Auth Required): Hacker News, REST Countries, Polymarket, Kalshi, Wikipedia, ArXiv, PubMed, SEC EDGAR

Deployment & DevOps: GitHub Actions, CircleCI, Docker Hub, npm Registry, PyPI

Danube OpenClaw Skill - ClawHub

What this skill does

Install

Full SKILL.md