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

# API Reference

> HTTP API endpoints for PraisonAI services

# API Reference

This section documents all HTTP API endpoints exposed by PraisonAI packages.

## Deploy APIs

Server endpoints for deployed agents. See [Deploy](/docs/deploy/index) for setup guides.

<CardGroup cols={2}>
  <Card title="Agents API" icon="server" href="/docs/deploy/api/agents-api">
    HTTP REST endpoints for agent servers
  </Card>

  <Card title="MCP API" icon="plug" href="/docs/deploy/api/mcp-api">
    Model Context Protocol endpoints
  </Card>

  <Card title="A2A API" icon="robot" href="/docs/deploy/api/a2a-api">
    Agent-to-Agent protocol endpoints
  </Card>

  <Card title="AGUI API" icon="window" href="/docs/deploy/api/agui-api">
    AG-UI protocol for CopilotKit
  </Card>
</CardGroup>

## Other APIs

<CardGroup cols={2}>
  <Card title="Voice Call API" icon="phone" href="/docs/api/praisonai/call/endpoints">
    Twilio voice integration with OpenAI Realtime
  </Card>

  <Card title="Async Jobs API" icon="clock" href="/docs/api/praisonai/async-jobs/index">
    Background job execution endpoints
  </Card>
</CardGroup>

## Base URLs

| Service       | Default URL                    |
| ------------- | ------------------------------ |
| Agents Server | `http://localhost:8000/{path}` |
| MCP Server    | `http://localhost:8080/sse`    |
| A2A Server    | `http://localhost:8000/a2a`    |
| AGUI Server   | `http://localhost:8000/agui`   |

## Quick Test

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Health check
curl http://localhost:8000/health

# Send query
curl -X POST http://localhost:8000/ask \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello"}'
```

## Error Responses

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "detail": "Error message"
}
```

| Status | Description  |
| ------ | ------------ |
| `400`  | Bad request  |
| `401`  | Unauthorized |
| `404`  | Not found    |
| `500`  | Server error |