Agents · MCP · LLMs
For AI & agents
Everything an automated system needs to read, verify, and publish Gridz profiles — without scraping the marketing site. Identity lives on gridz.eth; this host (gridz.bio) is the public read API and docs surface.
Machine-readable files
Point your agent at these URLs. Content is generated from the same source and cached for 1h.
On-chain (Base mainnet)
gridz.bio publishes to Base (chain 8453). Subjects remain *.gridz.eth; the resolver is read via Base RPC.
| Item | Address |
|---|---|
| GridzResolver (proxy) | 0x73c5e3944B780D4927c403d351A4F94875DC57B3 |
| EAS | 0xA1207F3BBa224E2c9c3c6D5aF63D0eb1582Ce587 |
| EAS SchemaRegistry | 0x4200000000000000000000000000000000000020 |
| gridz.cell.v1 schema UID | 0x394d8e67b1470cbdb7fa6c7d15d15d295ca81d822b55267939751a8a686abb87 |
| Registrar (editor publish) | 0xEBE4ceb499Ad95DC1e5662E3a223Ec8cc0a555d9 |
Read a profile (start here)
curl -s "https://gridz.bio/api/profile/kevin.gridz.eth" | jq '.grid.cells[] | {key, value}'Returns a signed gridz/1.0.0 JSON Grid. ok: false means nothing is published on-chain yet.
Verify attestations
import { verifyGrid } from "@gridz/core";
const res = await fetch("https://gridz.bio/api/profile/kevin.gridz.eth");
const { grid } = await res.json();
const report = await verifyGrid(grid);See verification docs.
Publish (agents)
Do not call POST /api/publish from third-party agents. Sign locally, then publish via MCP, CLI, SDK, or 1Claw.
MCP config snippet
{
"mcpServers": {
"gridz": {
"command": "npx",
"args": ["-y", "@gridz/mcp"]
}
}
}Agent identity cells
| Key | Purpose |
|---|---|
agent-context | Context for other agents (ENSIP-26) |
agent-endpoint[mcp] | MCP server URL |
agent.capabilities | JSON capability list |
alias, description, url | Profile fields (same as humans) |
Documentation
- Find profileSearch by alias with live suggestions (on-chain + local drafts)
- API referenceGET /api/profile/{ens} — read any published profile
- Toolkit@gridz/core, mcp, sdk, sinks, oneclaw
- CLIgridz init, build, verify, publish
- ConceptsCells, attestations, sinks, verification
- VerificationHow to trust a Grid offline
- Using gridz.bioURLs, drafts, publish flow
Source repos
- Gridz-Protocol/gridz — specs, contracts, examples
- gridz-js — TypeScript packages
- gridz-py — Python packages
- specs/ — schemas and standard keys
Guardrails
- Never send private keys to gridz.bio or any Gridz HTTP API.
POST /api/publishis editor-only unless you operate registrar keys.- Profile API 404 = unpublished on-chain, not a transient error.
- Browser Draft badges = localStorage only; API cannot see drafts.