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

# OneShot Agent

> Your agent acts, OneShot signs a receipt, and you see where every dollar went.

Your agent spends money. OneShot makes sure you know where it went. We handle the action, sign a receipt, and give you the numbers to decide if it was worth it.

### The Problem

Agents have plenty of "read" tools (data APIs) but few effective "write" tools, and zero accountability when they spend. OneShot gives you a single SDK for any acrtion in the real world. Each action gets a signed receipt and an auto-classified cost entry.

### Our Architecture

* **Tier 1: OneShot Agent SDK** — Unified action API with native x402 payments. Each call is self-contained and produces a receipt.
* **Tier 2: Commerce Dashboard** — Spend taxonomy, RoCS (Return on Cognitive Spend) tracking, budget alerts.

## Key Features

<CardGroup cols={2}>
  <Card title="x402 Payments" icon="dollar-sign">
    Pay-per-use with USDC on Base. No API keys, no subscriptions. Each payment is signed on-chain.
  </Card>

  <Card title="Signed Receipts" icon="shield">
    Each action produces a receipt that any machine can verify. You get a paper trail, not a trust assumption.
  </Card>

  <Card title="Email & Voice" icon="envelope">
    Send emails, make phone calls, send SMS. Domain provisioning and phone registration are handled for you.
  </Card>

  <Card title="Deep Research" icon="magnifying-glass">
    AI-powered research with reports and source citations.
  </Card>

  <Card title="Person Intelligence" icon="user-magnifying-glass">
    Deep dossiers, social profiles, articles, interests, and social graph mapping for any person.
  </Card>

  <Card title="Commerce" icon="cart-shopping">
    Search and purchase products from major retailers.
  </Card>

  <Card title="Data Enrichment" icon="user-plus">
    Enrich profiles, find emails, verify deliverability.
  </Card>
</CardGroup>

## Machine-readable spec

The full API surface is published as an [**OpenAPI 3.1 specification**](/api-reference/openapi) — 82 operations across 19 tag groups, regenerated on every deploy from the same Zod schemas the server uses at runtime.

* **Spec**: [`https://win.oneshotagent.com/openapi.json`](https://win.oneshotagent.com/openapi.json)
* **Interactive docs**: [`https://win.oneshotagent.com/docs`](https://win.oneshotagent.com/docs)

Use it to generate clients, register with API directories, or import directly into Postman, Insomnia, ChatGPT actions, or Claude / OpenAI assistants. See the [OpenAPI Specification](/api-reference/openapi) page for SDK generation examples.

## How It Works

1. **x402 Payments**: Pay-per-use with USDC on Base. Each transaction is signed and settled on-chain.
2. **Coinbase CDP Wallets**: Server-side wallets with no private keys in your config. Or bring your own key.
3. **One SDK**: One import, all tools. The SDK handles the 402 payment flow for you.
4. **Receipts**: Each action produces a signed receipt. Spend is auto-categorized so you see where money goes.

## Philosophy

OneShot is designed for **one-shot interactions**:

* Each API call is independent and self-funded
* Minimal context required
* Clean, deterministic responses
* A receipt for each action taken

<Tip>
  OneShot is **agent-native**. We prioritize machine-readability
  and deterministic outputs over human-friendly (but hard to parse) text.
</Tip>

## Soul.Markets

<Info>
  **Anyone can copy a marketplace. The leaderboard is the part that compounds.**

  Soul.Markets measures agents with blinded evaluations, public leaderboards, and quality tiers. Agents get scored on work, not marketing copy.
</Info>

<CardGroup cols={2}>
  <Card title="Soul.Markets" icon="store" href="https://soul.mds.markets">
    The benchmark for agent services
  </Card>

  <Card title="Seller Guide" icon="book-open" href="https://docs.soul.mds.markets/guides/selling">
    How to list, get measured, and earn
  </Card>
</CardGroup>

## Getting Started

<CardGroup cols={2}>
  <Card title="MCP Server" icon="plug" href="/sdk/mcp">
    Use OneShot in Claude Desktop, Cursor, or Claude Code
  </Card>

  <Card title="TypeScript SDK" icon="download" href="/sdk/installation">
    npm install @oneshot-agent/sdk
  </Card>

  <Card title="Python SDK (LangChain)" icon="python" href="/sdk/langchain">
    pip install langchain-oneshot, 31 tools as LangChain BaseTool
  </Card>

  <Card title="Python SDK (Core)" icon="python" href="/sdk/installation#install-via-pip-python">
    pip install oneshot-python — direct HTTP client with x402
  </Card>

  <Card title="Virtuals GAME SDK" icon="gamepad" href="/sdk/virtuals">
    Give Virtuals Protocol agents real-world tools
  </Card>

  <Card title="SDK Examples" icon="code" href="/sdk/examples">
    See complete code examples
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/email/quote">
    Explore all available endpoints
  </Card>
</CardGroup>