--- title: "Developer & Agent Resources | Himalayan Travel Guide" description: "Public content API quickstart, OpenAPI specification, MCP servers and agent discovery for nepaltibetbhutan.com — no API key required." canonical: "https://www.nepaltibetbhutan.com/developers" image: "https://www.nepaltibetbhutan.com/_next/static/images/everest-base-camp-hero-1280.webp" --- Developers & AI agents # Build on the Himalayan Travel Guide public content API. Read-only access to published destination, activity and guide content from nepaltibetbhutan.com. Every endpoint is public — no API key, token, sandbox or registration is required — and errors are machine-readable problem documents. **Auth** none required **Versioned** /api/v1/ **Format** JSON & Markdown Quickstart ## Start with three requests List the published destination and activity pillars, then read the guides for one pillar, then fetch a single guide. Rate limits allow 120 read requests per minute. - `GET /api/pillars` — published pillars with guide counts. - `GET /api/pillars/nepal/guides?limit=20` — first 20 Nepal guides; `X-Next-Cursor` continues the list. - `GET /api/guides/nepal/nepal-travel-visa` — one guide with sections, FAQs and references. Every HTML page also returns Markdown with `Accept: text/markdown`, or at the same URL with a `.md` suffix — for example [/nepal/nepal-travel-visa.md](/nepal/nepal-travel-visa.md). ## Endpoints - `GET /api/settings` — Read public site settings - `GET /api/pillars` — List published destination and activity pillars - `GET /api/pillars/{pillar}/guides` — List published guides for a pillar - `GET /api/pillars/{pillar}/landing` — Read a pillar landing payload - `GET /api/guides/{pillar}/{guide}` — Read one published guide - `GET /api/transportation/routes` — List published Nepal transportation routes - `GET /api/transportation/vehicle-rates` — List public Nepal vehicle-hire rates - `POST /api/v1/batch` — Run a batch of read operations in one request - `POST /api/v1/guide-exports` — Start an async guide export job - `GET /api/v1/guide-exports/{id}` — Poll a guide export job - `GET /api/v1/sandbox/pillars` — List sandbox fixture pillars - `POST /api/planning-enquiries` — Submit a planning enquiry - `POST /api/v1/settings` — - `POST /api/v1/pillars` — - `POST /api/v1/pillars/{pillar}/guides` — - `POST /api/v1/pillars/{pillar}/landing` — - `POST /api/v1/guides/{pillar}/{guide}` — - `POST /api/v1/transportation/routes` — - `POST /api/v1/transportation/vehicle-rates` — - `POST /api/v1/planning-enquiries` — The same routes are published under `/api/v1/`; the unversioned paths are stable aliases. Deprecations will be announced with Sunset headers before removal. ## Errors, rate limits and safe writes Errors are RFC 9457 `application/problem+json` documents with `title`, `status`, `detail` and `instance`; 422 responses add field-level `errors`. Throttled responses carry `Retry-After`. The single write endpoint, `POST /api/planning-enquiries`, accepts an `Idempotency-Key` header so a network retry cannot submit the same planning request twice. Do not send passwords, payment details, passport scans or medical records. ## Machine-readable resources - [OpenAPI 3.1 specification](https://www.nepaltibetbhutan.com/openapi.json) — Machine-readable API contract; also at /api/openapi.json. - [API documentation](https://www.nepaltibetbhutan.com/api/docs) — Markdown endpoint reference with versioning policy, errors and rate limits. - [API catalog](https://www.nepaltibetbhutan.com/.well-known/api-catalog) — RFC 9727 linkset catalog. - [AI catalog](https://www.nepaltibetbhutan.com/.well-known/ai-catalog.json) — Agentic Resource Discovery catalog of MCP servers, the API and skills. - [MCP server](https://www.nepaltibetbhutan.com/mcp) — Read-only JSON-RPC 2.0 transport with search/read tools (POST only); server card at /.well-known/mcp/server-card.json. - [Docs MCP server](https://www.nepaltibetbhutan.com/docs/mcp) — Documentation-only MCP transport. - [Agent card](https://www.nepaltibetbhutan.com/.well-known/agent-card.json) — A2A-style capability card. - [Protected resource metadata](https://www.nepaltibetbhutan.com/.well-known/oauth-protected-resource) — RFC 9728 document for this public resource server. - [Authorization server metadata](https://www.nepaltibetbhutan.com/.well-known/oauth-authorization-server) — agent_auth block with the anonymous identity type; endpoints under /agent/auth/. - [Agent Skills index](https://www.nepaltibetbhutan.com/.well-known/agent-skills/index.json) — SKILL.md files with verifiable digests: travel planning and permit checklists. - [Agent access notes](https://www.nepaltibetbhutan.com/auth.md) — auth.md walkthrough — anonymous access, no registration required. - [Ask endpoint](https://www.nepaltibetbhutan.com/ask) — Natural-language search over published guides (NLWeb-style). - [Schema feeds](https://www.nepaltibetbhutan.com/schemamap.xml) — NLWeb schema map listing the JSONL structured-data feeds (/feeds/*.jsonl). - [Agent plugin manifest](https://www.nepaltibetbhutan.com/plugin.json) — Agent Plugins packaging; mcp.json and skills/ live in the repository root. - [Repository agent instructions](https://www.nepaltibetbhutan.com/AGENTS.md) — AGENTS.md describing how AI coding agents should work in this codebase. - [Developer content map](https://www.nepaltibetbhutan.com/developers/llms.txt) — Scoped llms.txt for developers and agents (also /docs/llms.txt and /api/llms.txt). - [LLM content map](https://www.nepaltibetbhutan.com/llm.txt) — Full Markdown map of public guide content. ## Agents and MCP Agents can mirror the whole discovery surface over MCP: initialize a JSON-RPC 2.0 session at `/mcp` and read the API catalog, OpenAPI description, API documentation and content map as resources. A documentation-only transport is available at `/docs/mcp`, and natural-language lookup works at `/ask` with a `query` parameter. Keep building ## Continue inside the developer surface. [OpenAPI specification →](https://www.nepaltibetbhutan.com/openapi.json)[API documentation](https://www.nepaltibetbhutan.com/api/docs)[Agent access notes](https://www.nepaltibetbhutan.com/auth.md)[Developer llms.txt](https://www.nepaltibetbhutan.com/developers/llms.txt) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.nepaltibetbhutan.com/#organization","name":"Himalayan Travel Guide","description":"A practical, source-aware travel planning library for Nepal, Tibet, Bhutan, Mount Kailash and the wider Himalaya, published at nepaltibetbhutan.com.","url":"https://www.nepaltibetbhutan.com/","logo":{"@type":"ImageObject","@id":"https://www.nepaltibetbhutan.com/#logo","url":"https://www.nepaltibetbhutan.com/_next/static/images/himalayan-travel-guide-logo.webp"},"founder":{"@id":"https://www.nepaltibetbhutan.com/author-dinesh-bhusal#person"},"parentOrganization":{"@id":"https://www.amigotrekking.com/#organization"},"sameAs":["https://www.amigotrekking.com/"],"address":{"@type":"PostalAddress","addressLocality":"Kathmandu","addressCountry":"NP"},"contactPoint":{"@type":"ContactPoint","contactType":"editorial corrections","email":"info@amigotrekking.com"}},{"@type":"Organization","@id":"https://www.amigotrekking.com/#organization","name":"Amigo Treks \u0026 Expedition","url":"https://www.amigotrekking.com/"},{"@type":"WebSite","@id":"https://www.nepaltibetbhutan.com/#website","name":"Himalayan Travel Guide","url":"https://www.nepaltibetbhutan.com/","publisher":{"@id":"https://www.nepaltibetbhutan.com/#organization"},"inLanguage":"en"}]} {"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://www.nepaltibetbhutan.com/developers#webpage","url":"https://www.nepaltibetbhutan.com/developers","name":"Developer \u0026 Agent Resources","description":"Public content API quickstart, OpenAPI specification, MCP servers and agent discovery for nepaltibetbhutan.com.","isPartOf":{"@id":"https://www.nepaltibetbhutan.com/#website"}},{"@type":"BreadcrumbList","@id":"https://www.nepaltibetbhutan.com/developers#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Himalayan home","item":"https://www.nepaltibetbhutan.com/"},{"@type":"ListItem","position":2,"name":"Developer resources","item":"https://www.nepaltibetbhutan.com/developers"}]}]} ```