{
  "name": "PrivoDirect Universal API",
  "version": "1.0.0",
  "status": "operational",
  "authentication": "Bearer pd_live_<secret>",
  "protocols": {
    "mcp": {
      "endpoint": "https://api.privodirect.online/api/mcp",
      "description": "Model Context Protocol for AI Agents (Claude Desktop, Claude Code, Cursor)"
    },
    "rest": {
      "base_url": "https://api.privodirect.online/v1",
      "description": "Standard REST API for n8n, Make, Zapier, Python, Node.js, cURL"
    }
  },
  "endpoints": [
    {
      "method": "POST",
      "path": "/v1/messages/send",
      "description": "Send real Instagram DM"
    },
    {
      "method": "GET",
      "path": "/v1/conversations",
      "description": "List inbox conversations"
    },
    {
      "method": "GET",
      "path": "/v1/conversations/:id/messages",
      "description": "Get messages"
    },
    {
      "method": "POST",
      "path": "/v1/conversations/:id/handoff",
      "description": "Pause bot for human takeover"
    },
    {
      "method": "POST",
      "path": "/v1/conversations/:id/return-to-bot",
      "description": "Resume bot"
    },
    {
      "method": "GET",
      "path": "/v1/contacts",
      "description": "List contacts and leads"
    },
    {
      "method": "POST",
      "path": "/v1/contacts/:id/tags",
      "description": "Add tag to contact"
    },
    {
      "method": "DELETE",
      "path": "/v1/contacts/:id/tags",
      "description": "Remove tag from contact"
    },
    {
      "method": "GET",
      "path": "/v1/flows",
      "description": "List automation flows"
    },
    {
      "method": "GET",
      "path": "/v1/flows/:id",
      "description": "Get flow details"
    }
  ]
}