Mezcal docs

Start with Quickstart, then move into Build, Agents, or the live API reference without losing the explorer context.

The same REST contract powers the dashboard you see on this host, the SDK, and the CLI. MCP is the separate tool surface for coding agents. Pick a path below or open the core HTTP catalog first, then use the reference pages when you need deeper context.

First request

Validate this deployment

Paste this into requests.http, confirm the host and key, then decide whether the next step belongs in Build, Agents, the API reference, or the live explorer.

bash
@mezcal = https://<your-mezcal-host>/api
@chain = SN_MAIN
@apiKey = mzk_live_your_key_here

GET {{mezcal}}/v1/{{chain}}/status
X-Starkscan-Api-Key: {{apiKey}}
Open quickstart

Choose a path

By job

Integrate, automate, or explore—use the surface that matches the work.

Quickstart for wiring and keys. Build when you are choosing REST vs SDK vs CLI. Agents for MCP and tool-calling clients. API reference when you need exact HTTP operations, the OpenAPI file, or try-it requests. Deeper reference catalogs stay available, but they should not compete with the primary HTTP path.

QuickstartBuildAgentsAPI referenceReference catalogsLive product

HTTP contract

Core explorer API in one place

API reference is generated from the same OpenAPI artifact as the TypeScript SDK and CLI. Use it for paths and parameters; use the REST guide for workflows, auth expectations, and common pitfalls.

Docs structure

Four lanes, one product.

Quickstart is the default first stop. Build, Agents, and the API reference exist as clear follow-on lanes instead of competing top-level transports.

Build

Pick HTTP, CLI, SDK, or agents—then stay on the same contract.

All application paths compile against the public OpenAPI surface. Start with HTTP when you want zero install; move to the SDK for typed clients or the CLI for shell automation.

Start here

REST API

HTTP API

Interactive try-it reference generated from the Mezcal OpenAPI contract, with live request execution and auth support.

  • Live request execution
  • Best for application and pipeline integrations
Open
Local-first

CLI

Command Line

Shell-first workflows for token reads, transfer exports, hosted API validation, and privacy-sensitive local analysis.

  • Local-first execution
  • Best for exports and operational workflows
Open
Agent-ready

Agents

Agents and MCP

Claude Code, Codex, and hosted HTTP MCP transport docs with setup, auth, tool reference, and rollout guidance.

  • Hosted MCP and stdio setup
  • Best for agent workflows and tool calling
Open
Typed

SDK

TypeScript SDK

Typed TypeScript client usage for application code built against the same public contract used by the explorer UI.

  • Typed TypeScript client
  • Best for app teams building on the public contract
Open

Live product

Same data as the API—rendered in the explorer.

Open these in a new context on this host when you want to compare JSON payloads to what users see in the UI.