Transport Protocol

• Protocol: MCP Streamable HTTP (2025-03-26 specification)
• Supported Methods: POST (JSON-RPC 2.0), GET (server info)
• SSE Streaming: Not supported (returns 405 Method Not Allowed)
• Session Management: Stateless (no session ID required)

MCP Endpoint

https://awrag.io/api/v1/mcp

Primary MCP server endpoint for Claude.ai integration

OAuth Discovery Endpoint

https://awrag.io/.well-known/oauth-authorization-server

OAuth 2.0 server metadata for automatic client configuration

Protocol Version

MCP 2025-03-26 (Streamable HTTP)

Model Context Protocol with Streamable HTTP transport (GET/POST support)

Supported Operations

Tool: search_documents
Type: Read-only (non-destructive)
Description: Search user's document library using vector similarity
Parameters:
  - query (required): Natural language search query
  - project_ids (optional): Filter by specific project UUIDs
  - limit (optional): Number of results (default: 5, max: 20)

Security

• OAuth 2.0 with PKCE (Proof Key for Code Exchange)
• Row Level Security (RLS) for multi-tenant data isolation
• TLS 1.3 encryption for all API communication
• Access tokens expire after 30 days (configurable)
• Refresh tokens for seamless re-authorization