Tools and goals

OneShot is the execution layer for AI agents. It sells two things, built on the same tools.

A tool

A tool is one complete action at a known price. You call it with its inputs and get the result.

Complete. OneShot picks the provider, handles the failure, and retries until the action lands. See guaranteed execution.
Priced before it runs. Most tools have a fixed price. Tools whose cost varies, such as a phone call or a purchase, quote first. See pricing.
Recorded. Every paid call returns a signed receipt.

const result = await agent.research({ topic: 'Regional demand for cold storage in Ohio' });

A goal

A goal is an outcome with a budget. You say what done looks like and how much may be spent, and OneShot decides the steps: it plans, calls tools, waits on replies, and retries until the goal is met.

You set the limits. A budget, an optional deadline, and which actions need your approval. See approvals.
It can run for hours or days. A goal can wait for an email reply or pace its own outreach.
Unspent budget comes back as credits when the goal ends.

const goal = await agent.compute({
  objective: 'Book five distributor meetings in Germany for our grinder',
  budget_usdc: 200,
});

Goals run through Compute.

How they connect

A goal is tools plus a decision about the order. The tools a goal uses are the same ones you can call directly, and each goal OneShot solves becomes a tool for the next one. Each tool that ships moves the ceiling up.

The tools

Seven categories. Each name links to its reference page, and the SDK overview lists the method for each.

Messaging

Tool	What it does
Email	Send an email, with attachments
Voice Call	Place a phone call with a stated objective
SMS	Send a text message
Email Inbox	List inbound email
Read Email	Read one inbound email
SMS Inbox	List inbound text messages
Read SMS	Read one inbound text message

LinkedIn messaging runs through a connected account and has its own reference section.

Research & Enrich

Tool	What it does
Deep Research	Research a topic and return a report with sources
People Search	Find people by criteria
Research Person	Build a full dossier on one person
Social Profiles	Find a person’s social accounts
Article Search	Find articles about a person
Person Newsfeed	Recent social posts with engagement
Person Interests	A person’s interests by category
Person Interactions	Followers, following, and replies
Enrich Profile	Fill in a profile from a profile URL or an email
Find Email	Find a person’s work email
Verify Email	Check that an email address is deliverable
Company Search	Find companies by name, industry, location, or size
Enrich Company	Fill in a company record from a domain or name
Local Search	Find local businesses by category and place
Local Resolve	Turn a business name and address into a domain and phone
Government Solicitations	Find federal notices with the contracting officer’s contact

Web & Browser

Tool	What it does
Web Search	Search the web
Web Read	Read a page as markdown, with a screenshot
Browser	Run a task in a browser: navigate, click, extract
Create Profile	Create a browser profile that keeps a signed-in session
List Profiles	List browser profiles
Delete Profile	Delete a browser profile

Build

Tool	What it does
Build Site	Build and deploy a website
Update Build	Change a site that is already deployed

Commerce

Tool	What it does
Product Search	Search for products
Purchase	Buy a product and track the order

Account

Tool	What it does
Notifications	List the agent’s notifications
Mark Read	Mark a notification as read
Get Balance	Read the agent’s wallet balance

Compute

Tool	What it does
Compute	Create a goal with an objective and a budget
Goal Status	Read a goal’s state and result
Compute Budget	Read what a goal has spent and has left
Fund Goal	Add budget to a recurring goal
Pause Goal	Pause a recurring goal
Resume Goal	Resume a paused goal

What is coming

The roadmap lists the tools and goals that are being built or planned. Anything on this page can be called today.

​A tool

​A goal

​How they connect

​The tools

​Messaging

​Research & Enrich

​Web & Browser

​Build

​Commerce

​Account

​Compute

​What is coming