# supe

> supe gives AI agents 2,000+ paid tools (search, scraping, people and company data, email, SMS, calls, images, video, speech) from one prepaid wallet, inside limits the user sets.

Quick facts for agents:

- Fastest setup for an agent with a shell: read https://oex.sh/SKILL.md and follow it. It installs the `supe` CLI (`npm i -g @supe-sh/cli`) and signs in with `supe login --email <user's email>`.
- No shell: MCP at https://service.oex.sh/mcp (Streamable HTTP, OAuth or `Authorization: Bearer <key>`).
- Code: HTTP API at https://service.oex.sh/v1, `Authorization: Bearer <key>`, contract at https://service.oex.sh/v1/openapi.json.
- The loop: find a tool (free), inspect it (free), run it (billed). Tool ids are `provider#name`. Input is `{path, query, body}`.
- Prices are in credits: 1,000 credits = $1. A failed call is never charged.
- Actions that can't be undone wait for the user's yes (CLI exit 3, HTTP 409 needs_confirmation). Never pass a confirmation the user hasn't agreed to.
- A refusal by the user's rules is an answer, not an error. Tell the user; never retry with another tool to get around it.
- Every page below is Markdown at its URL plus `.md`. All pages in one file: /llms-full.txt


- **Get started**
- [Introduction](/index.md): Give your agent 2,000+ paid tools from one wallet, inside limits you set.
- [Quickstart](/quickstart.md): From nothing to your agent's first tool call in about two minutes.
- [How it works](/how-it-works.md): Tools, runs, credits and your rules, in one page.

- **Connect your agent**
- [Skill and CLI](/connect/skill.md): The recommended way. One line gives any agent with a shell the supe command and the instructions to use it.
- [MCP](/connect/mcp.md): Add supe to an AI app that can't run commands, like Claude or ChatGPT, or to any MCP client.
- [HTTP API](/connect/api.md): Call supe from your own code with an API key.

- **Use it**
- [Find and run a tool](/use/find-and-run.md): Search the tools, read one's parameters and price, then run it.
- [Runs and budgets](/use/runs-and-budgets.md): Cap a job's spending and get one receipt for every call in it.
- [Confirmations](/use/confirmations.md): Actions that can't be undone wait for a yes. Some wait for Face ID too.
- [Files](/use/files.md): Turn a local file into a link a tool can read.
- [Recipes](/use/recipes.md): Jobs of several steps, written down once.
- [Long jobs](/use/long-jobs.md): Video, research and calls that take minutes.

- **Controls**
- [Limits](/controls/limits.md): Budgets, the ask-me rule, which tools agents may use, and the pause button.
- [Approvals](/controls/approvals.md): Say yes or no to what your agents ask for.
- [Wallet and credits](/controls/wallet.md): One prepaid balance for every agent. 1,000 credits are $1.
- [Webhooks](/controls/webhooks.md): Get told when money moves, a budget fills or an agent needs you.

- **Reference**
- [CLI](/reference/cli.md): Every supe command and flag.
- [HTTP API](/reference/http-api.md): The /v1 endpoints and what they return.
- [MCP tools](/reference/mcp-tools.md): What an MCP client sees at https://service.oex.sh/mcp.
- [Errors and exit codes](/reference/errors.md): Every refusal, what it means and what to do. Nothing is charged for any of them.