> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Connect to Danube and make your first tool call in under 5 minutes

## Overview

This guide will help you connect your AI assistant to Danube and execute your first tool. We'll use Cursor as an example, but the same approach works for any MCP client.

<Info>
  **The Danube MCP Server:** `https://mcp.danubeai.com/mcp`
</Info>

## Step 1: Get Your API Key

<Steps>
  <Step title="Sign Up or Log In">
    Go to [danubeai.com](https://danubeai.com) and create an account or sign in.
  </Step>

  <Step title="Navigate to API Keys">
    Click on **API Keys**.
  </Step>

  <Step title="Create a New Key">
    Click **Create API Key**, give it a name like "My MCP Client", and copy the key.
  </Step>
</Steps>

## Step 2: Choose Your Integration

<Tabs>
  <Tab title="MCP Clients">
    Connect your AI assistant to Danube via the Model Context Protocol:

    <CardGroup cols={3}>
      <Card title="Claude Desktop" href="/mcp-clients/claude-desktop">
        Anthropic's desktop app
      </Card>

      <Card title="Claude Code CLI" href="/mcp-clients/claude-code">
        Terminal AI assistant
      </Card>

      <Card title="Codex" href="/mcp-clients/codex">
        OpenAI's desktop app
      </Card>

      <Card title="Codex CLI" href="/mcp-clients/codex-cli">
        OpenAI's terminal agent
      </Card>

      <Card title="Cursor" href="/mcp-clients/cursor">
        AI-powered code editor
      </Card>

      <Card title="Windsurf" href="/mcp-clients/windsurf">
        Codeium's code editor
      </Card>

      <Card title="Other" href="/mcp-clients/other-clients">
        Any MCP client
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Python SDK">
    Install the SDK and start using tools programmatically:

    ```bash theme={null}
    pip install danube
    ```

    ```python theme={null}
    from danube import DanubeClient

    with DanubeClient(api_key="dk_...") as client:
        # Search for tools
        tools = client.tools.search("send email")

        # Execute a tool
        result = client.tools.execute(
            tool_name="Gmail - Send Email",
            parameters={
                "to": "user@example.com",
                "subject": "Hello from Danube!"
            }
        )

        if result.success:
            print(result.content)
    ```

    <Card title="Python SDK Docs" icon="python" href="/sdk/python">
      Full SDK reference with async support, workflows, error handling, and more
    </Card>
  </Tab>

  <Tab title="OpenClaw">
    Install Danube as a skill in [OpenClaw](https://openclaw.ai/), the open-source personal AI assistant:

    ```bash theme={null}
    npm i -g clawhub
    clawhub install danube
    bash ~/.clawhub/skills/danube/scripts/setup.sh
    ```

    When prompted, enter your Danube API key. The setup script configures OpenClaw automatically.

    <Card title="OpenClaw Integration Guide" icon="puzzle-piece" href="/sdk/openclaw">
      Full setup guide, troubleshooting, and architecture details
    </Card>
  </Tab>
</Tabs>

## Step 3: Make Your First Tool Call

<AccordionGroup>
  <Accordion title="List Available Services">
    **MCP Prompt:** *"What services are available on Danube?"*

    **SDK:** `client.services.list(limit=5)`
  </Accordion>

  <Accordion title="Search for Tools">
    **MCP Prompt:** *"Search for tools related to news"*

    **SDK:** `client.tools.search("news")`
  </Accordion>

  <Accordion title="Execute a Tool">
    **MCP Prompt:** *"Get the top 5 stories from Hacker News"*

    **SDK:** `client.tools.execute(tool_name="Hacker News - Get Top Stories With Content")`
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tools not appearing (MCP)">
    * Make sure you completely restarted your MCP client
    * Check that your API key is correct
    * Verify the JSON/TOML syntax in your config file
  </Accordion>

  <Accordion title="401 Unauthorized errors">
    * Your API key may be invalid or expired
    * For MCP clients, ensure the header is named exactly `danube-api-key` (lowercase)
    * Generate a new API key from the dashboard
  </Accordion>

  <Accordion title="Connection timeout">
    * Check your internet connection
    * Verify the server is reachable: `curl https://mcp.danubeai.com/mcp/health`
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={3}>
  <Card title="MCP Clients" icon="plug" href="/mcp-clients/claude-desktop">
    Detailed setup for every MCP client
  </Card>

  <Card title="Python SDK" icon="python" href="/sdk/python">
    Full SDK reference and examples
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    REST API documentation
  </Card>
</CardGroup>