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

# MCP

> Connect your AI agent to Ateve's hosted MCP server.

The Ateve MCP server exposes `ateve_web_search`, a tool that searches the web and returns source URLs with concise excerpts.

## Configuration

```text theme={null}
https://mcp.ateve.ai/mcp
```

<Steps>
  <Step title="Get your key">Create an API key in [Dashboard → API keys](https://ateve.ai/keys).</Step>

  <Step title="Add an MCP server">
    In your client's MCP settings, select a remote or Streamable HTTP server. Set the URL above and configure an `Authorization` header containing `Bearer ` followed by your API key.
  </Step>

  <Step title="Enable the search tool">
    Reload or reconnect the client, enable `ateve_web_search`, and try:

    ```text theme={null}
    Search for this week's AI model updates on openai.com and claude.ai, exclude reddit.com and twitter.com, and cite the sources.
    ```
  </Step>
</Steps>

For clients that use an `mcpServers` JSON configuration and support `url` and `headers`, the connection looks like this:

```json theme={null}
{
  "mcpServers": {
    "ateve": {
      "url": "https://mcp.ateve.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ATEVE_API_KEY"
      }
    }
  }
}
```

Replace the placeholder using your client's private credential settings. Configuration formats differ by client; a literal `$ATEVE_API_KEY` inside JSON is not automatically expanded by every client.

## Tool parameters

| Parameter         | Required | Description                                                                                          |
| ----------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `query`           | Yes      | Search query, 1–2,000 characters.                                                                    |
| `max_results`     | No       | Maximum results, up to 100.                                                                          |
| `date_range`      | No       | Filter by day, week, month, year, YYYY-MM-DD, YYYY-MM-DD..YYYY-MM-DD, YYYY-MM-DD.., or ..YYYY-MM-DD. |
| `include_domains` | No       | Only search these domains, up to 300. For example, `openai.com` and `claude.ai`                      |
| `exclude_domains` | No       | Exclude these domains, up to 300. For example, `reddit.com` and `twitter.com`                        |

```json Example tool arguments theme={null}
{
  "query": "AI model updates",
  "max_results": 5,
  "date_range": "week",
  "include_domains": ["openai.com", "claude.ai"],
  "exclude_domains": ["reddit.com", "twitter.com"]
}
```