ausca

<p align="center">
  <img src="https://ausca.com/favicon.svg" alt="Ausca" width="72" height="72" />
</p>

<h1 align="center">Ausca</h1>

<p align="center">
  Pay-per-call APIs and MCP services for AI agents: document OCR, document
  analysis, media transcription, remote browser sessions, and agent email
  inboxes. No account, no API keys; USDC on Base per call, a signed receipt
  for every completed invocation.
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/ausca"><img src="https://img.shields.io/npm/v/ausca?label=npm%20ausca" alt="npm ausca" /></a>
  <a href="https://www.npmjs.com/package/@ausca/sdk"><img src="https://img.shields.io/npm/v/%40ausca%2Fsdk?label=%40ausca%2Fsdk" alt="npm @ausca/sdk" /></a>
  <a href="https://pypi.org/project/ausca/"><img src="https://img.shields.io/pypi/v/ausca?label=PyPI%20ausca" alt="PyPI ausca" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-black" alt="MIT license" /></a>
  <a href="https://registry.modelcontextprotocol.io/v0/servers?search=com.ausca"><img src="https://img.shields.io/badge/MCP%20registry-com.ausca%2Fagent--services-black" alt="MCP registry" /></a>
  <a href="https://smithery.ai/servers/ausca/ausca"><img src="https://smithery.ai/badge/ausca/ausca" alt="Smithery" /></a>
</p>

Agents buy infrastructure the way they call tools: send the request, pay the
402 challenge within a hard USD cap you set, read the result and its
settlement proof. The catalog, prices, and schemas are immutable and public
at [ausca.com/catalog.json](https://ausca.com/catalog.json); the full agent
contract is [ausca.com/SKILL.md](https://ausca.com/SKILL.md).

## Services and prices

| Service | What it does | Price (USD) |
| --- | --- | --- |
| Document OCR | Normalized text with line confidence from one committed document | $0.25 per document |
| Document Analysis | Normalized forms, tables, signatures, or layout from one committed document | $0.30 to $0.75, sized by document bytes |
| Media Transcription | Normalized transcript of one committed audio or video file | $0.40 to $1.30, sized by media bytes |
| Browser Session | Remote browser with standard CDP access | $0.05 / 10 min, $0.10 / 30 min, $0.20 / 60 min |
| Agent Inbox | A renewable receive-only email address your agent owns | $0.05 / hour, $0.20 / day, $1.00 / week |
| Inbox Extension | Add time to an active inbox without changing its address | $0.05 / hour, $0.20 / day, $1.00 / week |

Prices are the public catalog values at the time of writing; the live
catalog is authoritative.

## Use it in 60 seconds

**MCP** (Claude Desktop, Cursor, any MCP host): the local server holds your
wallet and pays within your cap. Tools are derived from the live catalog.

```json
{
  "mcpServers": {
    "ausca": {
      "command": "npx",
      "args": ["-y", "ausca", "mcp"],
      "env": {
        "AUSCA_PRIVATE_KEY": "0x...",
        "AUSCA_MAX_PAYMENT_USD": "0.50"
      }
    }
  }
}
```

**TypeScript**

```ts
import { AuscaClient } from "ausca";

const client = AuscaClient.withLocalKey({
  privateKey: process.env.AUSCA_PRIVATE_KEY, // pays USDC on Base
  maxPaymentUsd: 0.5,                        // hard per-call cap
});

const outcome = await client.invoke("browser.session", { duration_seconds: 600 });
console.log(outcome.result, outcome.payment?.transaction);
```

**CLI**

```bash
npx ausca catalog
npx ausca price document.ocr
AUSCA_PRIVATE_KEY=0x... AUSCA_MAX_PAYMENT_USD=0.50 \
  npx ausca invoke browser.session '{"duration_seconds":600}'
```

**Python**

```bash
pip install ausca
```

```python
from ausca import AuscaClient

client = AuscaClient.with_local_key(private_key=key, max_payment_usd=0.50)
outcome = client.invoke("browser.session", {"duration_seconds": 600})
```

A remote MCP server also runs at `https://ausca.com/mcp` (Streamable HTTP)
for discovery, preparation, and state reads; payment always signs on your
side, which is why the local server exists.

## How payment works

Every service is an [x402 v2](https://ausca.com/.well-known/x402) payable
resource. An unsigned request returns the exact payment requirement; the
client pays it only if it fits your cap, then retries the same bytes with
the same idempotency key, so an uncertain retry can never buy twice.
Settlement is USDC on Base and every completed invocation carries a receipt
with a public, hash-only verification page. Payment rails are pluggable
behind one interface; the official `@x402/*` libraries do all signing.

Document and media services take an immutable artifact commitment instead
of raw bytes: `npx ausca commit file.pdf` uploads through the keyless
ingress and returns the commitment the offer input carries.

## What is in this repository

| Package | Registry | What it is |
| --- | --- | --- |
| [`ausca`](packages/ausca) | [npm](https://www.npmjs.com/package/ausca) | The front door: library, CLI, and local MCP server |
| [`@ausca/sdk`](packages/sdk) | [npm](https://www.npmjs.com/package/@ausca/sdk) | The typed engine: client, payment authorities, artifact store |
| [`ausca`](python/ausca) | [PyPI](https://pypi.org/project/ausca/) | Python client and CLI with the same ports |
| [`@ausca/ai-sdk`](packages/ai-sdk) | [npm](https://www.npmjs.com/package/@ausca/ai-sdk) | Vercel AI SDK tools for any x402 v2 resource |
| [`langchain-ausca`](packages/langchain-ausca) | [npm](https://www.npmjs.com/package/langchain-ausca) | LangChain tools for any x402 v2 resource |
| [`skills/`](skills) | [ausca.com](https://ausca.com/skills/document-ocr/SKILL.md) | Agent skills, mirrored from the live origin |

The service runtime is not in this repository; this is the complete public
buyer side. `server.json` carries the official MCP registry identity
`com.ausca/agent-services`.

## Links

- Agent contract: <https://ausca.com/SKILL.md>
- Live catalog: <https://ausca.com/catalog.json>
- OpenAPI: <https://ausca.com/openapi.json>
- x402 discovery: <https://ausca.com/.well-known/x402>
- Docs: <https://ausca.com/docs>

## License

MIT