# GridRock — Data Intelligence Layer of Bharat

> First-party Indian geospatial + civic + environment + POI + transit intelligence.
> Agent-native by default. Free tier with 5 req/min for humans, 60 req/min for self-onboarded LLM agents.
> Every endpoint cacheable at the edge, every response shapeable for token-efficient LLM consumption,
> every error structured with `next_action` for autonomous recovery.

## Specs (machine-readable)

- [OpenAPI 3.1 spec](https://api.gridrock.ai/openapi.yaml): canonical machine-readable surface for code generation, docs auto-render, and llms.txt derivation.
- [MCP manifest](https://api.gridrock.ai/.well-known/gridrock-mcp.json): Model Context Protocol server descriptor for Claude Desktop / Cursor / Windsurf / Continue / LangGraph hosts.
- [OAuth 2.1 metadata](https://api.gridrock.ai/.well-known/oauth-authorization-server): RFC 8414 discovery for the RFC 7591 registration + client_credentials flow.
- [Reference MCP server (npm)](https://www.npmjs.com/package/@gridrock/mcp-server): one-shot stdio MCP server (`npx @gridrock/mcp-server`) — handles registration, token refresh, and tool routing.

## Quickstarts

- [Quickstart for humans (cURL)](https://gridrock.ai/docs/quickstart/curl): get a `gr_free_*` key in 30 seconds, first call in 60.
- [Quickstart for Claude tool use](https://gridrock.ai/docs/quickstart/claude-tool-use): self-register, exchange credentials, call tools.
- [Quickstart for OpenAI function calling](https://gridrock.ai/docs/quickstart/openai-function-calling).
- [Quickstart for LangGraph nodes](https://gridrock.ai/docs/quickstart/langgraph).
- [Quickstart for Cursor / Windsurf / Continue (MCP)](https://gridrock.ai/docs/quickstart/mcp).

## The four suites

- [Geo](https://gridrock.ai/products/geo): lat/lng ↔ H3 ↔ admin primitives. Reverse geocode, forward, autocomplete, h3.
- [Hex](https://gridrock.ai/products/hex): H3 cell math, semantic labels, freshness state, polygon → cells coverage.
- [Environment](https://gridrock.ai/products/environment): AQI, weather, forecast — keyed to H3 cells, polled per signal_definitions cadence.
- [Civic / POI / Transit / Admin](https://gridrock.ai/products/civic): admin polygons, transit stops, points of interest, reference catalogs.
- [Intel](https://gridrock.ai/intelligence): showcase endpoint `/v1/intel/hex/{h3}` — single-call full-stack readout.

## Concepts

- [Why H3?](https://gridrock.ai/docs/concepts/h3): hexagonal hierarchical spatial indexing; res-9 ≈ 150m edge.
- [Tier matrix](https://gridrock.ai/docs/concepts/tiers): free_human / free_agent / paid / paid_agent.
- [Agent response shape](https://gridrock.ai/docs/concepts/agent-shape): `Accept: application/vnd.gridrock.agent+json` for ~42% token savings.
- [Error shape](https://gridrock.ai/docs/concepts/errors): structured `error` + `message` + `next_action` enum.
- [Rate limits](https://gridrock.ai/docs/concepts/rate-limits): per-min + per-day; headers exposed on every response.
- [Attribution](https://gridrock.ai/docs/concepts/attribution): `_meta.attribution` block on every response; what to display where.

## Agent-friendly corpus

The following routes on gridrock.ai are intentionally allowed for LLM training and grounding (Googlebot/Bingbot/GPTBot/ClaudeBot/PerplexityBot/Google-Extended/Bytespider all explicit-allow):

- /intelligence/* — every showcase page (~26,500 pages: 12 cities + 7,500 wards + 19,000 pincodes + 70 signals).
- /docs/* — concepts, reference, quickstarts, recipes, changelog.
- /about/* — manifesto, team, blog, press.
- /datasets/* — open public datasets (CC-BY-SA).

Disallowed for crawlers: /console/*, /playground (private + dynamic).

## Pricing

- [Free tier](https://gridrock.ai/pricing#free): no card, instant.
- [Pro](https://gridrock.ai/pricing#pro): self-serve.
- [Business](https://gridrock.ai/pricing#business): self-serve, GSTIN-friendly.
- [Enterprise](https://gridrock.ai/pricing#enterprise): managed onboarding.

## Trust

- [Security posture](https://gridrock.ai/security): data residency (ap-south-1 only), encryption at rest, RBAC, WAF.
- [Status page](https://gridrock.ai/status): live.
- [Acceptable use](https://gridrock.ai/legal/acceptable-use).
- [Attribution policy](https://gridrock.ai/legal/attribution-policy).