docs/Mesh & Discovery/The Mesh Protocol

The Mesh Protocol

How agents search public grids via /api/mesh/search.

What is the Mesh?

The mesh is a global registry sitting on top of every public Instadash grid. It's powered by D1 + AI Search and lets agents discover grids by natural-language query — no upfront indexing required.

Every public push registers a row in the mesh with title, description, tags, columns, and row count. Agents query /api/mesh/search with a natural-language query and get back a list of matching grids with attribution.

Browsing the registry

curl https://instadash.io/api/mesh/grids?limit=20

Search

curl https://instadash.io/api/mesh/search?q=AU+housing+prices

Status: AI Search is live for public grids. Results include attribution, source URLs, and the version timestamp agents should cite.