# Payman Connect

- [Payman Connect](https://paymanai.mintlify.app/introduction.md): Your agent does the work. Payman handles the money.
- [Quickstart](https://paymanai.mintlify.app/quickstart.md): One secret, one mount, one call.
- [Next.js](https://paymanai.mintlify.app/nextjs.md): The three Payman routes on the App Router.
- [Any framework](https://paymanai.mintlify.app/frameworks.md): Web-standard handlers for Hono, SvelteKit, Remix, Bun, Deno
- [MCP server](https://paymanai.mintlify.app/mcp-server.md): Payman in claude.ai, ChatGPT, Grok, Claude Desktop, Cursor — a URL for hosted chats, a command for local ones.
- [The connection](https://paymanai.mintlify.app/build/how-it-works.md): Consent, the held question, and the automatic replay.
- [Actions](https://paymanai.mintlify.app/build/actions.md): Run an instruction, handle one of four results.
- [Add it as a tool](https://paymanai.mintlify.app/build/tool-integration.md): One tool in the model loop you already run.
- [Approvals](https://paymanai.mintlify.app/build/approvals.md): Render payment approvals and receipts
- [Keys and environments](https://paymanai.mintlify.app/reference/keys.md): One secret, two environments, how credentials end.
- [The wire protocol](https://paymanai.mintlify.app/reference/http-api.md): The HTTP contract underneath the SDK
- [Security rules](https://paymanai.mintlify.app/reference/security-rules.md): What the SDK enforces and what stays yours.
- [Limits and errors](https://paymanai.mintlify.app/reference/limits-and-errors.md): Lifetimes, rate-limit keying, every error code.
- [Example app](https://paymanai.mintlify.app/reference/example-app.md): The whole pattern, as one small readable app.
- [Exchange an authorization code for a grant token](https://paymanai.mintlify.app/api-reference/connect/exchange-an-authorization-code-for-a-grant-token.md): Server to server, authenticated by the app key alone — there is no grant yet, and minting one is the point. The key decides only *which app is asking*; whether anything is minted at all was decided by a person at authorize time and is carried entirely by the code.
- [Read your own registration with your app key](https://paymanai.mintlify.app/api-reference/connect/read-your-own-registration-with-your-app-key.md): The self-read: the app's own registration, answered to the credential the app already holds. Registration metadata only — the values the developer registered, plus the console origin and endpoint paths an SDK needs to run the whole handshake without being separately configured with any of them.
- [Send a message to the granted deployment and wait for the answer](https://paymanai.mintlify.app/api-reference/connect/send-a-message-to-the-granted-deployment-and-wait-for-the-answer.md): Payman Connect resolves the grant to its one deployment, attaches that deployment's key and configuration, forwards the message, and returns what the agent said.
- [Send a message to the granted deployment and stream the answer](https://paymanai.mintlify.app/api-reference/connect/send-a-message-to-the-granted-deployment-and-stream-the-answer.md): The streaming form of `connectInteract`, relayed through the same proxy: the customer's agent's NDJSON verbatim, one JSON object per line. Anything that can fail cheaply fails before the first byte, so an early failure is still a normal JSON error; a mid-stream failure arrives as one final `StreamEr…
- [Answer a run that stopped to ask something](https://paymanai.mintlify.app/api-reference/connect/answer-a-run-that-stopped-to-ask-something.md): A money tool can stop a run to ask a question — which recipient, confirm this transfer — and the run blocks until it is answered. The answer goes back over the runtime's api-key surface, which the caller must never hold, so it is proxied here. No deployment segment in the path: the grant names the d…
- [Ask whether the account owner has approved a frozen operation yet](https://paymanai.mintlify.app/api-reference/connect/ask-whether-the-account-owner-has-approved-a-frozen-operation-yet.md): A state and a clock, for the app that is waiting.
- [The canonical payman_money_task tool definition](https://paymanai.mintlify.app/api-reference/connect/the-canonical-payman_money_task-tool-definition.md): The exact object a developer pastes into their agent's `tools` array, plus the four documented result shapes and the wire conditions that produce them.

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)