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.
https://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.
- Open Customize → Connectors and click Add custom connector.
- Paste the connector URL. Leave OAuth empty; if asked, choose No sign-in.
- Click Add, then turn it on in a chat from + → Connectors.
Team and Enterprise: an Owner adds it under Organization settings → Connectors → Add → Custom.
claude mcp add --transport http namashkar-bharat https://namashkarbharat.com/mcpAdd --scope user to use it in every project.
{
"mcpServers": {
"namashkar-bharat": {
"url": "https://namashkarbharat.com/mcp"
}
}
}Or use “Add to Cursor” in the menu at the top of this page.
code --add-mcp '{"name":"namashkar-bharat","type":"http","url":"https://namashkarbharat.com/mcp"}'{
"mcpServers": {
"namashkar-bharat": {
"type": "http",
"url": "https://namashkarbharat.com/mcp"
}
}
}Key names vary by client. stdio-only clients can bridge with: npx -y mcp-remote https://namashkarbharat.com/mcp
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.
curl -s https://namashkarbharat.com/api/directory \
| jq '.sites[] | select(.tags | index("passport")) | {name, url}'const res = await fetch("https://namashkarbharat.com/api/directory");
if (!res.ok) throw new Error((await res.json()).code); // problem+json
const { sites } = await res.json();
const official = new Set(sites.map((s) => s.domain));
official.has("passportindia.gov.in"); // trueimport json, urllib.request
with urllib.request.urlopen("https://namashkarbharat.com/api/directory", timeout=10) as r:
sites = json.load(r)["sites"]
print([s["url"] for s in sites if s.get("state") == "MH"][:5]){
"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.md | Instructions for agents: workflow, tools, hard rules. Paste into a system prompt. |
|---|---|
| /api/directory | The whole directory as JSON. CORS open, CDN-cached; fetch once a day. |
| /openapi.json | OpenAPI 3.1 for the directory API and its error model. |
| /llms.txt | What the site is and where everything is (llmstxt.org). |
| /.well-known/api-catalog | RFC 9727 linkset: the API, its OpenAPI and this page. |
/<page>.md | Any page as Markdown, or send Accept: text/markdown. |
WebMCP | In WebMCP browsers the site registers find_official_service, verify_official and open_directory_category. |
Show 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
/mcp | 120 req/min per network (more for known agent platforms); portal_status 12/min |
|---|---|
/api/directory, static files | No limit (CDN). Cache it; don't poll. |
/api/search, /api/feedback | This 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.
| code | status | what to do |
|---|---|---|
bad_request | 400 | The 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_short | 400 | The question is missing or shorter than 3 characters after cleaning. Describe what you need in a few words. |
too_long | 400 | The question is longer than 100 characters. Keep the question under 100 characters. |
links | 400 | The question contains a URL or `www.`. Describe the need in words. To check whether a URL is official, use the MCP connector's verify_official tool. |
gibberish | 400 | The question has too few letters or long runs of repeated characters. Use words that describe what you need. |
forbidden | 403 | The 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. |
verify | 403 | The Cloudflare Turnstile token was missing or invalid. The daily quota unit is refunded. Refresh the page and try again. |
unknown_search | 403 | The searchId/sig pair wasn't issued by /api/search today. Send feedback only for a searchId and sig returned by /api/search on the same day (IST). |
not_found | 404 | There is no endpoint or page at this path. See /agents for the available endpoints and /openapi.json for their description. |
method_not_allowed | 405 | The endpoint exists but doesn't support this HTTP method. Use one of the methods listed in the Allow header. |
too_large | 413 | The 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_type | 415 | The body's Content-Type isn't application/json or text/plain. Send Content-Type: application/json. |
burst | 429 | More 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. |
daily | 429 | This 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_limited | 429 | More than 60 feedback requests in a minute from one network. Slow down and retry after a minute. |
server_error | 500 | Something 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.