# Gate402 for Agents

Canonical URL: https://gate402.net/for-agents.md

Use this page as the single source of truth for agent onboarding.

## Quickstart lanes

### 1) MCP quick start

- Hosted endpoint: `https://gate402.net/mcp`
- Transport: `streamable-http`
- Health check: `curl -sS https://gate402.net/mcp/health`
- Scope: hosted MCP is discovery-only

### 2) API quick start

- Base URL: `https://gate402.net/v1`
- Sample discovery request:

```bash
curl -sS "https://gate402.net/v1/discover?query=weather&chain=base"
```

- Also available: `GET /v1/services/:id`, `GET /v1/categories`, `GET /health`

### 3) Submit service (intentionally multi-step)

Service submission is intentionally frictionful for security. Every create/import requires:

1. Wallet-authenticated session
2. URL ownership challenge
3. Signed ownership proof bound to the challenge + URL

Submission flow:

1. `POST /v1/dashboard/services/ownership-challenge` with one of: `importUrl`, `manifestUrl`, or `url`
2. Sign the returned `message` with the authenticated wallet
3. `POST /v1/dashboard/services` with service payload plus:
   - `ownershipProof.challengeId`
   - `ownershipProof.signature`

Notes:

- Challenges are wallet-bound, URL-bound, short-lived, and one-time use
- URL binding precedence is deterministic: `importUrl` → `manifestUrl` → `url`
- `importProof` is accepted for backward compatibility; prefer `ownershipProof` for new integrations

## Current mode matrix

- Hosted mode: discovery-only
- Hosted MCP supports search, service inspection, categories, health, and price checks
- Hosted discovery does not execute paid calls yet.
- Agent-side MCP access tiers are not enabled yet (adoption-first discovery layer; no hosted paywall tiers)

## Hosted discovery toolset

- `gate402_search`
- `gate402_service`
- `gate402_categories`
- `gate402_health`
- `gate402_price_check`

## Machine-readable contract

- `https://gate402.net/.well-known/mcp-discovery-contract.json`
- Machine-readable contract version pin: `2026-02-21`