> ## Documentation Index
> Fetch the complete documentation index at: https://glide-9da73dea.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent platform quickstart

> Spin up apps/mcp locally + connect Claude Desktop / ChatGPT / Vertex / OpenClaw / Hermes. The 30-minute path to a working agent banking environment.

This is the agent-platform-specific quickstart. For the broader Glide bring-up (web app + data layer), see the [main quickstart](https://glide-9da73dea.mintlify.site/oss/quickstart.md).

## Prerequisites

* Glide running locally per the [main quickstart](https://glide-9da73dea.mintlify.site/oss/quickstart.md) (Postgres on `localhost:5435`, Redis on `localhost:6381`, Inngest dev on `localhost:8288`, web on `localhost:3000`).
* Privy Multi-tenant tenant with `NEXT_PUBLIC_PRIVY_APP_ID` + `PRIVY_APP_SECRET` set.
* Node 22+, pnpm.

## Boot `apps/mcp`

```bash theme={null}
# In the axtior-neobank repo
pnpm --filter mcp dev
```

This boots the MCP gateway on `localhost:8787` with HMAC-SHA256 dev verifier. The dev secret is read from `MCP_TOKEN_VERIFIER_DEV_SECRET` in your `.env.local`.

Set a 32-byte hex secret if you haven't already:

```bash theme={null}
echo "MCP_TOKEN_VERIFIER_DEV_SECRET=$(openssl rand -hex 32)" >> apps/web/.env.local
```

## Sanity-check the gateway

```bash Public manifest (no auth) theme={null}
curl http://localhost:8787/mcp/manifest
```

```bash Tool catalog discovery (no auth, MCP spec) theme={null}
curl -X POST http://localhost:8787/mcp/read \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

```bash Health probes theme={null}
curl http://localhost:8787/healthz
curl http://localhost:8787/readyz
```

## Connect an agent runtime

The MCP gateway speaks MCP spec 2025-11-25. Any MCP-compliant runtime works. Glide ships partner pack drafts for the five hero runtimes — see [Partner registries](https://glide-9da73dea.mintlify.site/oss/headless/partner-registries.md).

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "glide-local": {
      "url": "http://localhost:8787/mcp/read",
      "headers": {
        "Authorization": "Bearer <hmac-signed-jwt>"
      }
    }
  }
}
```

For local dev, generate an HMAC-signed JWT against your dev secret. For production, you'd issue this through your Ory Hydra deployment per the [OAuth flow](https://glide-9da73dea.mintlify.site/oss/headless/oauth-flow.md).

### ChatGPT Apps

Submit through the [Partner registry submission flow](https://glide-9da73dea.mintlify.site/oss/headless/partner-registries.md) once you've stood up `auth.<your-domain>` + verified `mcp.<your-domain>`.

### Google Vertex / OpenClaw / Hermes

Same submission flow. Each pack has a `connector-manifest.json` template at `docs/designs/agent-distribution-partner-packs/<runtime>/`.

## Three confused-deputy-isolated endpoints

| Endpoint | Tools | Trust scope |
| - | - | - |
| `/mcp/read` | accounts, balances, transactions, agents, skills, audit stream, x402 receive | Read-only — no money movement |
| `/mcp/write` | payments, cards, transfers, beneficiaries, x402 pay | Money-touching; envelope-bound |
| `/mcp/treasury` | grant issuance, signer rotation, yield allocation, kill-switch | Admin-only; principal explicit |

**Confused-deputy guard:** a `read` token cannot call `write` or `treasury` tools. The check fires BEFORE auth so a sniffed token from one endpoint can't probe the others.

## Step-up via URL-mode elicitation

Tools that cross the policy envelope return JSON-RPC `-32003` with a `step_up_url`. The client surfaces that URL; the principal biometric-approves on the Glide web sheet at `localhost:3000/step-up/[sigil]`; the client follows the tool-specific approval flow. Only input schemas that include `step_up_sigil` accept it on a repeat call.

Sigils are CAS-claimed first-use-only (F7 IRON RULE).

## Where to next

* [OAuth flow](https://glide-9da73dea.mintlify.site/oss/headless/oauth-flow.md) — full RFC 7591 + 8707 + PKCE walk-through for production.
* [Tool reference](https://glide-9da73dea.mintlify.site/oss/headless/tool-reference.md) — every tool's input + output schema.
* [Self-hosting the agent platform](https://glide-9da73dea.mintlify.site/oss/headless/self-hosting.md) — Ory Hydra deploy + production posture.
* [Money-safety contracts](https://glide-9da73dea.mintlify.site/oss/concepts/money-safety-contracts.md) — the F-rules every tool path observes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.