For AI agents & developers

Agent Documentation

LocalePak is Pakistan's business directory — 183 cities, 24 categories. This page explains how an AI agent or developer can read the site: the free read-only JSON API, the MCP server, the public pages, what credentials are (not) needed, and what does not exist yet.

What you can do

Everything below reads public pages. No account, API key, or token is needed.

Search businesses

Find businesses by keyword, city, or category from the public search and listing pages — or via the JSON API / MCP tools.

Read via the JSON API

Free read-only API: GET /api/v1/businesses, /api/v1/businesses/{slug}, /api/v1/categories, /api/v1/cities. No key, max 20 per page, 60 req/min/IP.

Browse cities

183 cities across Pakistan, each with its own page and city-by-category listings.

Browse categories

24 business categories, from restaurants and real estate to healthcare and home services.

Read blog guides

Practical guides for Pakistani business owners, including local SEO and listing guidance.

Agent resources

Machine-readable files that describe the site. Fetch them directly — they are plain static files.

  • /llms.txttext/markdown

    llms.txt: Machine-readable overview: what LocalePak is, coverage, and key pages.

  • /auth.mdtext/markdown

    auth.md: How agents obtain credentials: none needed for public content; website sign-up for listing owners.

  • /pricing.mdtext/markdown

    pricing.md: Listing tiers in plain markdown: Basic PKR 99, Premium PKR 199, Featured PKR 299, one-time.

  • /index.mdtext/markdown

    index.md: Markdown twin of the homepage, linked from the homepage as an alternate.

  • /openapi.jsonapplication/json

    Public API (OpenAPI): OpenAPI 3.1 spec for the free read-only JSON API: search businesses, get one business, list categories and cities. No key, max 20 per page, 60 req/min/IP.

  • /api/mcpapplication/json

    MCP server: Streamable HTTP MCP endpoint (POST, JSON-RPC 2.0): tools search_businesses, get_business, list_categories, list_cities. Read-only, no authentication.

  • MCP server card: Server card for the MCP server: display name, logo, description, endpoint, and tool list.

  • Authorization-server metadata: RFC 8414 metadata stating honestly that LocalePak is not a full OAuth server: no authorization or token endpoint, no client registration.

  • Protected-resource metadata: RFC 9728 metadata for the public API resource, naming the real scopes listings:read (public) and listings:write (website session only).

  • Agent Skills index: Capabilities an agent can use: search businesses, browse cities and categories, read blog guides.

  • Agent card: A2A agent card: name, description, capabilities, and support contact.

  • /.well-known/ard.jsonapplication/json

    Agentic Resource Discovery: Catalog of the agent resources above, with domain-anchored identifiers.

  • /.well-known/api-catalogapplication/linkset+json

    API catalog: RFC 9727 linkset pointing at these docs and the sitemap.

  • /sitemap.xmlapplication/xml

    Sitemap: XML sitemap of the indexable public pages.

Authentication

Reading public content needs no credentials at all — no API key, no token, no OAuth. That covers the public pages, the JSON API (/api/v1/*), and the MCP server (/api/mcp). Listing owners who want to create or manage a listing sign up on the website itself at /register. There is no API key or programmatic token to obtain. The full walkthrough lives in auth.md. LocalePak is not a full OAuth server: there is no authorization endpoint, token endpoint, or third-party client registration — the metadata files say so plainly (see the resource list above).

Example requests

The read-only JSON API is the fastest way to read listings as data. It is free, needs no key, returns at most 20 results per page, and allows 60 requests per minute per IP. The full spec is /openapi.json. Only fields already public on the listing pages are returned — never owner emails, owner IDs, or payment data.

# Site overview (machine-readable)
curl https://www.localepak.com/llms.txt

# Search businesses via the JSON API (free, no key)
curl "https://www.localepak.com/api/v1/businesses?q=restaurants&city=Lahore"
curl "https://www.localepak.com/api/v1/businesses?category=technology&page=2"

# One business by slug
curl https://www.localepak.com/api/v1/businesses/nayatel

# Categories and cities
curl https://www.localepak.com/api/v1/categories
curl "https://www.localepak.com/api/v1/cities?q=lahore"

# MCP server: list tools, then call one (JSON-RPC 2.0 over POST)
curl -X POST https://www.localepak.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -X POST https://www.localepak.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_businesses","arguments":{"q":"restaurants","city":"Lahore"}}}'

# Public pages (same content as HTML)
curl https://www.localepak.com/
curl https://www.localepak.com/businesses
curl https://www.localepak.com/city/lahore/
curl https://www.localepak.com/category/restaurants/

# A single business profile
curl https://www.localepak.com/business/<slug>/

# Blog guides
curl https://www.localepak.com/blog
curl https://www.localepak.com/blog/<slug>/

# Agent resources
curl https://www.localepak.com/.well-known/agent-card.json
curl https://www.localepak.com/.well-known/ard.json
curl https://www.localepak.com/openapi.json
curl https://www.localepak.com/sitemap.xml

City and category slugs use lowercase hyphenated names, for example lahore and restaurants. Business slugs are the public slugs shown in listing URLs. On the homepage, browsers that support WebMCP (Chrome origin trial) also get an in-page search_businesses tool that opens the matching /search results in the same tab — no extra download on browsers without it.

Try it without signing up

There is no separate sandbox and no sandbox account to create: the read-only API and MCP server are free with no key and no signup, so the live endpoints above are the trial. Run the curl examples against the production URLs and you get real public data back. Writes are the only part that needs an account — and writes happen on the website itself, in a signed-in browser session, never through the API. If you are building an integration, start with GET /api/v1/businesses?q=<keyword> and keep to the limits: 20 results per page, 60 requests per minute per IP.

What does not exist yet

The JSON API and MCP server above do exist now. What still does not exist: write endpoints on the API (listings are added on the website only), an OAuth flow or API tokens, a Wikipedia/Wikidata article, a ChatGPT app listing, payment protocols (x402, UCP, AP2, ACP), SDK packages or a CLI, and an NLWeb /ask endpoint. Do not assume endpoints exist beyond the ones listed on this page, and do not send credentials to any third party claiming to offer LocalePak API access.

Pricing

Listing a business costs PKR 99 (Basic), PKR 199 (Premium), or PKR 299 (Featured) — one-time per listing. Browsing and reading are free, and so is the read-only API and MCP server (60 requests per minute per IP, 20 results per page). Full details in pricing.md.

Contact

Support: support@localepak.com
Helpline: +92 334 5636230
Office: Office 303, Evacuee Trust Complex, F-5/1, Islamabad 44000, Pakistan

Do not scrape the site in bulk. Cite the listing page URL you used.

LocalePak 24/7 Support Desk

Facing an issue with this website? Contact our support team and we will help you as soon as possible.

Whether you need help updating your business listing, reporting a concern, asking a platform question, or exploring advertising solutions, our dedicated team is here to assist you.