Ausca MCP Server

<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/agent-services"><img src="https://img.shields.io/badge/Smithery-ausca%2Fagent--services-black" 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; the full agent contract is ausca.com/SKILL.md.

Agent skills

Install one canonical skill from this public repository:

npx -y skills add auscahq/ausca --skill agent-inbox

Replace agent-inbox with browser-session, document-analysis, document-ocr, or media-transcription. Install all five with:

npx -y skills add auscahq/ausca --skill '*'

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.

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

TypeScript

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 }, {
  idempotencyKey: savedPurchaseKey,
  attribution: { source: "my-agent", campaign: "browser-workflow" }, // optional
});
console.log(outcome.result, outcome.payment?.transaction);

CLI

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}' --idempotency-key saved-browser-purchase-0001
  # Add --source my-agent [--campaign browser-workflow] for optional attribution.

Python

pip install ausca

from ausca import AuscaClient, InvocationAttribution

client = AuscaClient.with_local_key(private_key=key, max_payment_usd=0.50)
outcome = client.invoke(
    "browser.session",
    {"duration_seconds": 600},
    idempotency_key=saved_purchase_key,
    attribution=InvocationAttribution(source="my-agent", campaign="browser-workflow"),
)

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 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. Save a unique key before paying and retain it on uncertainty; starting another call with a new key is a new purchase. CLI and paid MCP calls require an explicit key. Resource admission contains private capabilities: never publish the raw result. See recovery examples. 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.

Optional source/campaign attribution is reporting metadata only and is excluded from pricing, payment, execution, and recovery identity. Caller labels are self-reported.

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	npm	The front door: library, CLI, and local MCP server
@ausca/sdk	npm	The typed engine: client, payment authorities, artifact store
ausca	PyPI	Python client and CLI with the same ports
@ausca/ai-sdk	npm	Vercel AI SDK tools for any x402 v2 resource
langchain-ausca	npm	LangChain tools for any x402 v2 resource
skills/	ausca.com	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