Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Etch public Discovery API
description: Signed audit chain for AI agent decisions, offline-verifiable against pinned public keys. Every event is signed with a hybrid Ed25519 + FIPS 205 SLH-DSA-SHA2-128f envelope, Merkle-chained into an epoch, and epoch-anchored on Sigstore Rekor + Bitcoin OpenTimestamps. This document covers only the unauthenticated integration surface; the admin API requires bearer authentication and is not published.
version: 0.2.0
license:
name: BUSL-1.1
url: https://spdx.org/licenses/BUSL-1.1.html
contact:
name: Etch
url: https://etch.systems
email: support@etch.systems
servers:
- url: https://etch.systems
description: Production
tags:
- name: Discovery
description: Well-known metadata endpoints for aggregators and MCP clients.
paths:
/.well-known/mcp/server-card.json:
get:
summary: SEP-1649 MCP Server Card; discoverable endpoint + version for aggregators
operationId: wellKnownMcpServerCard
tags:
- Discovery
responses:
'200':
description: OK
/.well-known/oauth-protected-resource:
get:
summary: RFC 9728 Protected Resource Metadata; declares bearer-only (no OAuth flow)
operationId: wellKnownOauthProtectedResource
tags:
- Discovery
responses:
'200':
description: OK
externalDocs:
description: Full documentation
url: https://etch.systems/docs