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.

ItemAddress
GridzResolver (proxy)0x73c5e3944B780D4927c403d351A4F94875DC57B3
EAS0xA1207F3BBa224E2c9c3c6D5aF63D0eb1582Ce587
EAS SchemaRegistry0x4200000000000000000000000000000000000020
gridz.cell.v1 schema UID0x394d8e67b1470cbdb7fa6c7d15d15d295ca81d822b55267939751a8a686abb87
Registrar (editor publish)0xEBE4ceb499Ad95DC1e5662E3a223Ec8cc0a555d9

specs/deployments.md · base.easscan.org

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

KeyPurpose
agent-contextContext for other agents (ENSIP-26)
agent-endpoint[mcp]MCP server URL
agent.capabilitiesJSON capability list
alias, description, urlProfile fields (same as humans)

Documentation

Source repos

Guardrails

  • Never send private keys to gridz.bio or any Gridz HTTP API.
  • POST /api/publish is 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.