> ## 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.

# Configuración e integración

> Configura Topsort Prompts e intégralo con Agent API o MCP.

## Opciones de integración

* **Agent API**: ideal para chat y conversaciones multi-turno
* **MCP Server**: ideal para integraciones personalizadas y acceso directo a herramientas

## Opción 1: Agent API

### Endpoint

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

### Headers

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

### Request de ejemplo

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

Campos clave: `query`, `session_id`, `max_results`, `max_sponsored`, `streaming`.

## Opción 2: MCP Server

### Conexión

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

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

Usa la herramienta `search_products` con parámetros como `query`, `max_results` y `max_sponsored`.

## Buenas prácticas

* Etiqueta claramente productos patrocinados (`is_sponsored: true`)
* Rastrea `resolvedBidId` para atribución
* Reutiliza `session_id` para mantener contexto conversacional
* Implementa retries con backoff para errores `5xx`