Build
Choose the right Mezcal integration surface for code and automation.
Loading documentation content…
Choose the right Mezcal integration surface for code and automation.
Choose the Mezcal surface by job.
| If you need... | Use... |
|---|---|
| exact HTTP contract, auth, retries, pagination | REST API |
| typed application code | TypeScript SDK |
| shell workflows or local exports | Agent CLI |
| tool-calling access for an agent | MCP |
export MEZCAL_BASE_URL="https://<your-mezcal-host>/api"
export MEZCAL_API_KEY="mzk_test_your_key_here"
export MEZCAL_CHAIN="SN_MAIN"
All build surfaces use the same hosted contract underneath.
X-Mezcal-Api-Key401 as missing or invalid credentials403 as a real scope or route-tier mismatchRetry-After on 503X-Request-Id/v1/* app routes are externalHigh-cardinality routes are cursor-based.
Expect:
limit parametersitems arraysnextCursor when another page existsaddress= filters on token transfersRepresentative routes:
GET /v1/{chain}/address/{address}/activity?limit=50GET /v1/{chain}/token/{token}/transfers?address=0xA&address=0xB&limit=100Treat the hosted /api lane as a bounded external service:
Retry-AfterFor multi-wallet monitoring, use Monitor 10 wallets.