> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pramaan.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pramaan

> Provider-neutral capabilities behind one API.

Pramaan gives you more than 600 capabilities, such as `web.search`, `companies.enrich`,
`email.send` and `payments.checkout.create`, behind one API key and one API. You call a
capability by its id; Pramaan picks the service behind it, fails over when it is down, and bills
you per call from prepaid credits.

* **One request shape:** `POST /v1/capabilities/{id}` with a JSON body.
* **Sync or async:** most capabilities answer right away; long-running ones return a job.
* **Your own accounts where it matters:** email, payments, auth, databases and deploys run on
  accounts you connect, and those calls are free.
* **Social and texting without setup:** connect social accounts with one sign-in link; phone
  numbers are provisioned for you.
* **Events back to you:** signed webhooks when a job finishes or a connected account changes.

## Start here

1. [Quickstart](https://docs.pramaan.dev/quickstart.md): from an API key to your first call in three commands.
2. [Jobs](https://docs.pramaan.dev/guides/jobs.md): run long capabilities and wait for them.
3. [MCP server](https://docs.pramaan.dev/tools/mcp.md) and [capability skill](https://github.com/Pramaan-Dev/capabilities-lab/blob/main/docs/skills/pramaan-capabilities/SKILL.md): connect an agent and follow the capability workflow.
4. The **API reference** tab: every capability, with its request, result, price and example.

## Basics

| | |
| - | - |
| Base URL | `https://api.pramaan.dev` |
| Auth | `Authorization: Bearer sk_live_...` |
| Prices | micro-USD (1,000,000 = \$1). Each response carries `X-Pramaan-Price-Micro`. |
| Request id | Every response carries `X-Request-Id` (`req_...`). Quote it when you ask for help. |
| Rate limit | 10 requests per second per key (bursts up to 20); job reads 30 per second. |

## Results are data, not instructions

Capability results come from third-party sources: web pages, profiles, posts, messages. Treat
them as untrusted data. If you pass them to a language model, never let their text act as
instructions.


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