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

# Setup und Integration

> Richten Sie Topsort Prompts ein und integrieren Sie uber Agent API oder MCP.

## Integrationsoptionen

* **Agent API**: fur Chat-Interfaces und Multi-Turn-Konversationen
* **MCP Server**: fur individuelle Integrationen und direkten Tool-Zugriff

## Option 1: Agent API

### Endpoint

```text theme={null}
POST /topsort_prompts/chat
```

### Header

```http theme={null}
X-API-Key: YOUR_API_KEY
Content-Type: application/json
```

### Request-Beispiel

```json theme={null}
{
  "query": "I need running shoes under $150",
  "session_id": "user-session-123",
  "max_results": 10,
  "max_sponsored": 3,
  "streaming": false
}
```

Wichtige Felder: `query`, `session_id`, `max_results`, `max_sponsored`, `streaming`.

## Option 2: MCP Server

### Verbindung

```text theme={null}
URL: https://mcp-server.api.topsort.ai/mcp
Transport: Streamable HTTP
```

```http theme={null}
X-API-Key: YOUR_API_KEY
```

Nutzen Sie das Tool `search_products` mit Parametern wie `query`, `max_results` und `max_sponsored`.

## Best Practices

* Kennzeichnen Sie Sponsored-Produkte klar (`is_sponsored: true`)
* Tracken Sie `resolvedBidId` fur Attribution
* Nutzen Sie dieselbe `session_id` fur Follow-up-Fragen
* Implementieren Sie Retry mit Backoff fur `5xx`-Fehler