Skip to main content
Pucho

Build with it

API & agent tools

The same knowledge base that powers the assistant is open to other apps and AI agents.

Search API

JSON search over the directory, schemes, guides and crawled official pages.

GET /api/search?q=passport+renewal
GET /api/search?q=land+records&state=karnataka&kind=site,page&limit=5

kind is any of guide, scheme, site, state, page. state is a state slug or india.

Answer API

Server-sent events from the research agent: status updates, answer text, and sources.

POST /api/ask
{ "question": "How do I get a driving licence?", "state": "kerala" }

data: {"type":"status","text":"Opening the guide for “driving licence”"}
data: {"type":"source","source":{"id":"S1","title":"Sarathi Parivahan","url":"https://sarathi.parivahan.gov.in/"}}
data: {"type":"text","delta":"You apply online through **Sarathi** [S1]…"}
data: {"type":"done","sources":[…]}

MCP server for AI agents

Plug the toolset into Claude Desktop, Claude Code or any Model Context Protocol client, so your own agent can research Indian government services.

# from the project folder
npm run mcp

# Claude Code
claude mcp add pucho -- npx tsx scripts/mcp-server.ts
  • search_official_sourcesFull-text search over crawled official pages and curated guides.
  • find_government_siteWhich ministry, department, portal or helpline handles something.
  • find_schemesSchemes filtered by audience (farmer, student, senior citizen…), topic and state.
  • get_service_guideStep-by-step guide for common tasks (passport, PAN, DL, ITR, RTI…).
  • get_state_profileFacts and key websites for any state or union territory.
  • fetch_official_pageLive text of a page on an official government domain.

Command line

npm run ask -- "Which schemes can a farmer in Odisha get?"