Developer Docs

Connect your AI to your knowledge base

REST API for automation. MCP server for AI assistants. Same knowledge base, same security.

MCP Setup Guide REST API Reference

MCP Server

Connect Claude Code, Claude Desktop, VS Code, or Cursor directly to your knowledge base. AI assistants can search, query, and review documents natively.

  • 4 tools: search, answer, list docs, get doc
  • 2 prompts: compliance check, document review
  • Same auth + rate limits as REST API

REST API

Build custom integrations, automate workflows, or embed knowledge search into your own applications. JSON in, JSON out.

  • Search, answer, chat (SSE streaming)
  • Document CRUD + file upload
  • API key scoping + rate limiting

MCP Setup

Connect your AI assistant in 3 steps.

1

Create an API key

Go to Settings → API Keys in your Puccha dashboard. Create a key with mcp.

2

Add to your MCP config

Claude Code

// ~/.claude/settings.json
{
  "mcpServers": {
    "puccha": {
      "type": "url",
      "url": "https://app.puccha.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

VS Code

// .vscode/settings.json
{
  "mcp": {
    "servers": {
      "puccha": {
        "type": "http",
        "url": "https://app.puccha.ai/api/mcp",
        "headers": {
          "Authorization": "Bearer puccha_live_YOUR_KEY"
        }
      }
    }
  }
}
3

Start using

Your AI assistant now has access to these tools:

puccha_search

Hybrid search — returns document chunks

puccha_answer

RAG answer with citations

puccha_list_docs

Browse the knowledge base

puccha_get_doc

Read full document content

REST API

All endpoints require an API key via Authorization: Bearer puccha_live_...

POST /api/search

Hybrid search (semantic + lexical). Returns ranked document chunks without LLM generation.

curl -X POST https://app.puccha.ai/api/search \
  -H "Authorization: Bearer puccha_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "PDPA requirements", "topK": 5}'
POST /api/answer

RAG answer with citations. Retrieves relevant docs, generates an answer grounded in your knowledge base.

curl -X POST https://app.puccha.ai/api/answer \
  -H "Authorization: Bearer puccha_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "วิธีขอความยินยอมตาม PDPA", "locale": "th"}'
POST /api/chat

Streaming chat with multi-turn context. Returns an SSE stream with text chunks and citations.

curl -N -X POST https://app.puccha.ai/api/chat \
  -H "Authorization: Bearer puccha_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "What is PDPA?", "locale": "en"}'

Full API reference with request/response schemas coming soon.

In the meantime, explore the API via the Playground in your dashboard.

Rate limits

Plan Queries/day Per key/hour MCP tools/hour
Free1006060
Team1,0006060
Business10,0006060
EnterpriseCustomCustomCustom