Namashkar Bharat

livemcprestllms.txtno key

Give your agent the official web.

A free, read-only toolkit that tells AI agents which Government of India sites are genuine and whether a portal is up. No sign-in, and it never needs anyone’s personal data.

connectorhttps://namashkarbharat.com/mcp
› verify_official({
  url: "passportindia-gov.in.co"
})

{
  "verdict": "not_official",
  "lookalike_of": "passportindia.gov.in",
  "advice": "Do NOT enter anything here."
}

Connect

One URL. Streamable HTTP, no sign-in, no key.

  1. Open Customize → Connectors and click Add custom connector.
  2. Paste the connector URL. Leave OAuth empty; if asked, choose No sign-in.
  3. Click Add, then turn it on in a chat from + → Connectors.

Team and Enterprise: an Owner adds it under Organization settings → Connectors → Add → Custom.

Verify: ask your agent “Is passportindia-gov.in.co official?” It should call verify_official and answer not official.

Tools

All read-only. Tool arguments are never logged.

find_official_service({ query })

Search the directory with a few English keywords and get the official URL.

verify_official({ url })

Official, not official (a look-alike or scam) or unknown. Call it before anyone types into a site.

portal_status({ service_id | url })

Is an official portal up, slow or down right now? Cached for 5 minutes.

Also: a usage guide resource (namashkar://guide) and a government_task prompt with the safe workflow.

REST API

GET https://namashkarbharat.com/api/directory returns the whole directory in one JSON response. CORS open, no key, CDN-cached: fetch it once a day. Schema in /openapi.json.

terminal
curl -s https://namashkarbharat.com/api/directory \
  | jq '.sites[] | select(.tags | index("passport")) | {name, url}'
200 · application/json
{
  "count": 1255,
  "categories": [{ "id": "identity", "name": "Identity & Documents", … }],
  "sites": [{
    "id": "passport-seva",
    "name": "Passport Seva",
    "url": "https://www.passportindia.gov.in",
    "domain": "passportindia.gov.in",
    "category": "identity",
    "org": "Ministry of External Affairs",
    "tags": ["passport", "passport renewal", …],
    "desc": "Apply for a new or renewed passport, …"
  }, …]
}

Files for agents

Public, read-only and keyless. Agents find them on their own via llms.txt, the api-catalog and link headers.

/agents.mdInstructions for agents: workflow, tools, hard rules. Paste into a system prompt.
/api/directoryThe whole directory as JSON. CORS open, CDN-cached; fetch once a day.
/openapi.jsonOpenAPI 3.1 for the directory API and its error model.
/llms.txtWhat the site is and where everything is (llmstxt.org).
/.well-known/api-catalogRFC 9727 linkset: the API, its OpenAPI and this page.
/<page>.mdAny page as Markdown, or send Accept: text/markdown.
WebMCPIn WebMCP browsers the site registers find_official_service, verify_official and open_directory_category.
Show agents.md
agents.md
# Namashkar Bharat: instructions for AI agents

For AI agents helping a person with an Indian government service. v1.3 · 2026-10-01 · https://namashkarbharat.com/agents.md

Namashkar Bharat (https://namashkarbharat.com) is an independent, read-only guide to 1,255 official Government of India and state websites. It is not a government website. It never needs personal data, and it doesn't submit, track or pay for anything: the official portal does.

## Connect

- MCP (preferred): `https://namashkarbharat.com/mcp` (Streamable HTTP, no sign-in, no key). Claude Code: `claude mcp add --transport http namashkar-bharat https://namashkarbharat.com/mcp`
- REST: `GET https://namashkarbharat.com/api/directory` (whole directory as JSON; cache it, refresh at most daily)
- Setup for other clients, examples, limits and error codes: https://namashkarbharat.com/agents

## Tools

- `find_official_service`: call first, with a few English keywords ("renew passport"). Never put personal data in the query.
- `verify_official`: call on every URL before anyone enters anything there, and again after redirects or links from SMS or email.
- `portal_status`: call when an official portal seems down or slow.

## Workflow

1. `find_official_service` for the need.
2. `verify_official` before entering any data. `official`: continue. `not_official`: warn, stop, offer `lookalike_of`. `unknown`: ask the person to confirm the address from an official source.
3. Guide the person through the official site.
4. STOP at every login, OTP, CAPTCHA, payment, final submit, e-sign, consent, document upload, biometric or in-person step, and hand over to the person.

## Hard rules

- Never type, store, repeat or send Aadhaar, PAN, passport or bank numbers, passwords or OTPs. The person types them.
- Never solve or bypass a CAPTCHA.
- Use only URLs `verify_official` calls `official`. The official portal is authoritative.
- Tell the person Namashkar Bharat is an independent guide, not the government.

## Errors and limits

- REST errors: `application/problem+json` with a stable `code` and a `hint` (https://namashkarbharat.com/agents#errors). MCP: JSON-RPC or tool errors with a message.
- MCP: about 120 requests/min per client, `portal_status` 12/min. Over a limit (HTTP 429), wait and retry.

Report problems: https://x.com/ajinkya_shejul

Limits & errors

/mcp120 req/min per network (more for known agent platforms); portal_status 12/min
/api/directory, static filesNo limit (CDN). Cache it; don't poll.
/api/search, /api/feedbackThis site's own pages only (403 elsewhere)

Every /api error is RFC 9457 application/problem+json with a stable code and a hint; type links to the row below. /mcp returns JSON-RPC errors instead.

codestatuswhat to do
bad_request400The body isn't the JSON object the endpoint expects (malformed JSON, `null`, an array, unknown fields or a filled-in honeypot). Send a JSON object with only the documented fields.
too_short400The question is missing or shorter than 3 characters after cleaning. Describe what you need in a few words.
too_long400The question is longer than 100 characters. Keep the question under 100 characters.
gibberish400The question has too few letters or long runs of repeated characters. Use words that describe what you need.
forbidden403The endpoint only serves namashkarbharat.com's own pages (Origin / Sec-Fetch-Site check). Use GET /api/directory (public, CORS-enabled) or the MCP connector at /mcp instead.
verify403The Cloudflare Turnstile token was missing or invalid. The daily quota unit is refunded. Refresh the page and try again.
not_found404There is no endpoint or page at this path. See /agents for the available endpoints and /openapi.json for their description.
method_not_allowed405The endpoint exists but doesn't support this HTTP method. Use one of the methods listed in the Allow header.
too_large413The body is over the endpoint's limit (2 KB for /api/search, 1 KB for /api/feedback). Send a smaller body; only the documented fields are needed.
unsupported_type415The body's Content-Type isn't application/json or text/plain. Send Content-Type: application/json.
burst429More than 1 search in 3 seconds or 6 in a minute from one network, or a search sent less than 0.8 s after the page loaded. Wait a few seconds (see Retry-After) and try again.
daily429This network has used its smart searches for today. Cached answers still work. The limit resets at midnight IST (see resetIn and Retry-After, in seconds). Browse /directory or use /api/directory meanwhile.
rate_limited429More than 60 feedback requests in a minute from one network. Slow down and retry after a minute.
server_error500Something unexpected failed on our side. Nothing was stored. Retry later. If it keeps happening, report it on X (@ajinkya_shejul).

Rules

  • Agents hand over to the person at every login, OTP, CAPTCHA, payment, final submit, e-sign, consent, upload and in-person step.
  • Never send personal data (Aadhaar, PAN, phone, passwords, OTPs) to any endpoint here. None of them need it.
  • Nothing you send is stored. The connector doesn't log queries or URLs; rate limits use a salted hash of the network address.
  • Send people to the official site itself, never a copy or a paid intermediary.
  • Namashkar Bharat is an independent guide, not a government website, and has no uptime guarantee.

Questions, broken links, data requests: @ajinkya_shejul on X.

AI agents & developers · Namashkar Bharat