# auth.md

This file describes how AI agents can authenticate with and provision access to Quicknode.

**Resource:** https://api.quicknode.com
**Auth spec:** https://workos.com/auth-md

---

## Supported Registration Methods

Quicknode supports two agent registration paths — x402 pay-per-request (no account required) and API key (account required).

### x402 — Anonymous, Pay-Per-Request

Agents can access blockchain data without a user account by paying per request using the x402 protocol.

- **identity_types_supported:** `["anonymous"]`
- **credential_types_supported:** `["x402"]`
- **payment_endpoint:** https://x402.quicknode.com
- **payment_info:** https://www.quicknode.com/.well-known/x402.json
- **agent_guide:** https://www.quicknode.com/agents.md

No registration step required. Include the x402 payment header on each request.

### API Key — Provisioned via Agent Subscription API

Agents can autonomously provision a Quicknode subscription and RPC endpoint using the Agent Subscription API, paid via x402 or MPP.

- **identity_types_supported:** `["anonymous"]`
- **credential_types_supported:** `["api_key"]`
- **register_uri:** https://www.quicknode.com/api/v1/agent/subscriptions
- **provisioning_guide:** https://www.quicknode.com/agents/create-endpoint.md

---

## Scopes

| Scope | Description |
|---|---|
| `endpoints:read` | Read RPC endpoint details |
| `endpoints:write` | Create and manage RPC endpoints |
| `streams:read` | Read Streams configuration |
| `streams:write` | Create and manage Streams |

---

## Discovery Documents

- Agent card: https://www.quicknode.com/.well-known/agent-card.json
- API catalog: https://www.quicknode.com/.well-known/api-catalog
- OpenAPI spec: https://www.quicknode.com/openapi.json
- x402 payment info: https://www.quicknode.com/.well-known/x402.json
- MCP server: https://www.quicknode.com/.well-known/mcp/server-card.json
- Agent skills: https://www.quicknode.com/.well-known/agent-skills/index.json

---

## Support

Docs: https://www.quicknode.com/docs
Agent integration guide: https://www.quicknode.com/agents.md