> ## 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.

# Tools and goals

> The two things OneShot sells. A tool is one complete action at a known price. A goal is an outcome with a budget.

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](/introduction#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](/pricing).
* **Recorded.** Every paid call returns a [signed receipt](/api-reference/analytics/receipts).

```typescript theme={null}
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](/api-reference/approvals/overview).
* **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.

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

Goals run through [Compute](/api-reference/compute/create).

## 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](/sdk/overview#supported-tools) lists the method for each.

### Messaging

| Tool | What it does |
| - | - |
| [Email](/api-reference/email/send) | Send an email, with attachments |
| [Voice Call](/api-reference/voice/call) | Place a phone call with a stated objective |
| [SMS](/api-reference/sms/send) | Send a text message |
| [Email Inbox](/api-reference/inbox/list) | List inbound email |
| [Read Email](/api-reference/inbox/get) | Read one inbound email |
| [SMS Inbox](/api-reference/sms/inbox-list) | List inbound text messages |
| [Read SMS](/api-reference/sms/inbox-get) | Read one inbound text message |

[LinkedIn messaging](/api-reference/linkedin/overview) runs through a connected account and has its own reference section.

### Research & Enrich

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

### Web & Browser

| Tool | What it does |
| - | - |
| [Web Search](/api-reference/web-search) | Search the web |
| [Web Read](/api-reference/web-read) | Read a page as markdown, with a screenshot |
| [Browser](/api-reference/browser/create) | Run a task in a browser: navigate, click, extract |
| [Create Profile](/api-reference/browser/profiles) | Create a browser profile that keeps a signed-in session |
| [List Profiles](/api-reference/browser/profiles) | List browser profiles |
| [Delete Profile](/api-reference/browser/profiles) | Delete a browser profile |

### Build

| Tool | What it does |
| - | - |
| [Build Site](/api-reference/build/create) | Build and deploy a website |
| [Update Build](/api-reference/build/update) | Change a site that is already deployed |

### Commerce

| Tool | What it does |
| - | - |
| [Product Search](/api-reference/commerce/search) | Search for products |
| [Purchase](/api-reference/commerce/buy) | Buy a product and track the order |

### Account

| Tool | What it does |
| - | - |
| [Notifications](/api-reference/notifications/list) | List the agent's notifications |
| [Mark Read](/api-reference/notifications/read) | Mark a notification as read |
| Get Balance | Read the agent's wallet balance |

### Compute

| Tool | What it does |
| - | - |
| [Compute](/api-reference/compute/create) | Create a goal with an objective and a budget |
| [Goal Status](/api-reference/compute/status) | Read a goal's state and result |
| [Compute Budget](/api-reference/compute/budget) | Read what a goal has spent and has left |
| [Fund Goal](/api-reference/compute/fund) | Add budget to a recurring goal |
| [Pause Goal](/api-reference/compute/pause) | Pause a recurring goal |
| [Resume Goal](/api-reference/compute/resume) | Resume a paused goal |

## What is coming

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.