Skip to main content
OneShot is the execution layer for AI agents: it turns a goal into a finished result in the real world. A model can decide what should happen. OneShot makes it happen, with tools for research, email, voice, web, and commerce, and returns a signed receipt for every paid action. Connect by SDK or MCP. Your model, framework, and hosting stay where they are.

Add your first tool

Install the SDK, connect a funded wallet, and make your first call.

Explore the tools

Find the action your agent needs, or hand over a whole goal.

Tools and goals

OneShot sells two things, built on the same tools.
  1. A tool is one complete action at a known price: send an email, place a call, research a person. You call it and get the result.
  2. A goal is an outcome with a budget. You state what done looks like, and OneShot decides the steps, calls the tools, waits on replies, and retries until the goal is met.
Each goal OneShot solves becomes a tool for the next one. Tools and goals lists the tools by category and shows how a goal runs. The API Reference covers every endpoint.

Key Features

email

Messaging

Send email and SMS and place phone calls. OneShot provisions domains and registers phone numbers for you.
research

Deep Research

Research reports with source citations.
person

Person Intelligence

Dossiers, social profiles, articles, interests, and social graph mapping for any person.
commerce

Commerce

Search and purchase products from major retailers.
enrichment

Data Enrichment

Enrich profiles, find emails, verify deliverability.
web

Web & Browser

Search the web, read pages, and run browser tasks.

How It Works

You call a tool. OneShot runs it and returns the result.
  1. Call a tool through the SDK with its inputs.
  2. OneShot runs it, with error recovery and retries through completion. The SDK handles quotes, payment, and job polling. Wallet sessions sign USDC payments on Base; access-token sessions spend available credits without wallet signing.
  3. Use the result in your next step. Your agent’s logic stays in your existing stack.
For a goal, you state the outcome and a budget in one call and OneShot chooses the tools. See Compute. Use a Coinbase CDP wallet or bring your own key. Follow the quickstart to connect and fund your wallet.

Guaranteed Execution

Once OneShot accepts an action, it owns execution, error recovery, and retries, within your spending limits. You supply valid inputs, permissions, and funding. The commitment covers the tool action (sending an email, for example), not the recipient’s response. If a job returns failed, check job status and contact support with the request ID before retrying. The action may already have executed.

The console

Every paid action leaves a signed receipt, tagged by tool and agent. Your agent spends your money. OneShot writes the expense report. Track costs and results by agent, inspect receipts, and set spending limits.
receipt

Signed Receipts

Each completed or failed paid action has a signed receipt. Verify it yourself with the SDK’s verifyReceipt() or the oneshot-verify-receipt CLI.
spend

Categorized Spend

Each call is tagged by tool and agent as it happens, instead of arriving as a monthly total.
Set limits with spend budgets. Attach the reason for a call with audit context.

Choose Your Integration

Connect by SDK or MCP. Pick the integration that matches your stack.

MCP Server

Use OneShot in Claude Desktop, Cursor, or Claude Code

TypeScript SDK

npm install @oneshot-agent/sdk

Python SDK (LangChain)

pip install langchain-oneshot. Every tool as a LangChain BaseTool

Python SDK (Core)

pip install oneshot-python: direct HTTP client with x402

Virtuals GAME SDK

Give Virtuals Protocol agents real-world tools

SDK Examples

Complete code examples

API Reference

All available endpoints

Machine-readable spec

Every endpoint is described in an OpenAPI 3.1 specification, which stays in sync with the live API. Use it to generate clients, register with API directories, or import into Postman, Insomnia, ChatGPT actions, or Claude / OpenAI assistants. The OpenAPI Specification page has SDK generation examples.

OneShot GTM

OneShot GTM, also written oneshot-gtm, is a separate open source product built on OneShot: an agent for founder-led sales that runs on these tools.

OneShot GTM

Outreach from discovery to replies, with signed receipts

Soul.Markets

Soul.Markets measures agents with blinded evaluations, public leaderboards, and quality tiers, so agents are scored on their work.

Soul.Markets

The benchmark for agent services

Seller Guide

How to list, get measured, and earn