win.oneshotagent.com

Returns a 402 quote for the configured `to_address` list. Pay via x402 then call `/v1/tools/email/send`.

Quote-to-Pay: first call returns 402 with a quote; pay via x402 then retry. Async — returns `request_id`.

Email campaign analytics for a domain

Returns every domain owned by the verified agent with its pool/warmup state. The rotation selector draws from `pool_status=active`.

Pause a domain (keep in pool, exclude from rotation)

Resume a paused domain

Cost: $0.0035 per segment per recipient. Quote-to-Pay: first call returns 402 with a quote. Supports single recipient or array (max 100).

Cost: $0.35/minute + $5.00 number registration on the first call. Quote-to-Pay. The agent calls `target_number`, follows the `objective`, and returns a transcript + outcome via the async job result.

Deep web research on a topic

Find people matching criteria

Deep research on a specific person

Get social profiles for a person

Find articles about a person or company

Get a person's social newsfeed

Get a person's interests

Get a person's recent social interactions

Search companies

When durable enrichment is enabled, same-key/same-input retries return the original job and receipt. Accepted jobs can finish and be billed after client cancellation.

When durable enrichment is enabled, same-key/same-input retries return the original job and receipt. Accepted jobs can finish and be billed after client cancellation.

Enrich company data

Main-street businesses (restaurants, contractors, practices, auto shops) by category/keywords × location. Flat price per search. Results carry domain, operating_status, phone, category, is_chain, rating, review_count, and a stable id.

Given a business name and at least one locating field (address, city, postal_code, or phone), returns the matching business with a confidence score. A miss completes with `found: false` rather than an error.

SAM.gov Sources Sought / Presolicitation notices (and other notice types) by NAICS code, each with the contracting officer's published contact, agency, response deadline, set-aside, and a description body for the first rows. Flat price per search. Zero notices is a completed job, not an error.

When durable enrichment is enabled, supply a stable Idempotency-Key. Accepted work can finish and be billed after client cancellation. Replay and credit admission use a fresh wallet proof with scope submit.

Cost: $0.001. Returns search results inline (synchronous, not async).

Cost: $0.002. Async — poll the returned `request_id` for the markdown output.

Quote-to-Pay. The agent purchases the specified product on the agent's behalf.

Search products

Requires a write-scoped wallet proof. Does not purchase or send mail.

Requires a write-scoped wallet proof. Does not purchase or send mail.

Requires a write-scoped wallet proof. Does not purchase or send mail.

Requires a submit-scoped wallet proof and Idempotency-Key. Approval and quote are bound to the owner. Payment settles before Lob submission. Recover the same key after any uncertain response.

Upload immutable print-ready artwork (20 MB maximum)

getPhysicalMailQuote

getPhysicalMailOrder

recoverPhysicalMailOrder

Request cancellation; provider confirmation is required after submission

Quote-to-Pay. Generates a single-page website with the supplied brand, products, and lead capture.

Quote-to-Pay. The agent drives a real browser to complete the task.

List browser profiles

Create a persistent browser profile

Delete a browser profile

Owner-authenticated live browser setup. Never log live_url. Finish saves state and inspects cookies before site navigation; it does not assert site authentication.

Owner-authenticated live browser setup. Never log live_url. Finish saves state and inspects cookies before site navigation; it does not assert site authentication.

Owner-authenticated live browser setup. Never log live_url. Finish saves state and inspects cookies before site navigation; it does not assert site authentication.

Get agent on-chain + credit balance

List agent notifications

Mark all notifications as read

Mark a single notification as read

Returns the agent's configured spend budget plus live utilization for the current UTC day. Agents with no budget row are unlimited: `daily_usdc` is null and `spent_today_usdc` is still reported. Readable with an agent access token; for token sessions `spent_today_usdc` includes credit-funded calls, since credits are what they pay with.

Upserts the agent's spend budget. Fields are tri-state: an absent key leaves the stored value alone, an explicit `null` clears it (for `alert_at`/`pause_at`, resets to the default 0.8 / 1.0), a number sets it — so a partial update never wipes the caps it didn't mention. Enforced server-side against the receipt ledger on every paid call; over-budget calls receive 403 `budget_exceeded`. The SDKs send this once automatically when constructed with a `budgets` config. Refused with 403 `budgets_read_only_for_access_tokens` for agent access-token sessions — a delegated credential must not be able to raise its own cap.

Lists this agent's access tokens (prefix, label, last use, revocation, and credit-funded spend attributed to each token today). Plaintext tokens are never returned. Pass `active=true` to hide revoked tokens.

Creates a revocable, credits-only bearer credential for this agent, for use where the wallet key cannot be (hosted MCP clients, cloud runners). The plaintext `token` is returned once and never stored; keep it secret. Token sessions pay from the agent's credit balance, count against the stored daily budget, and cannot change budgets or mint other tokens. At most 20 active tokens per agent (`too_many_access_tokens`).

Revokes one of this agent's tokens. Sessions using it fail with 401 `access_token_revoked` from the next request.

Returns the agent behind the caller's credential: its id and wallet address, plus which credential type authenticated the call. Access-token sessions use this to learn the wallet address the job-status routes key on.

Model Context Protocol over Streamable HTTP, for clients that cannot run a local process (Grok Bot, hosted runners). Same 53 tools as `@oneshot-agent/mcp-server`. Authenticate with an agent access token; tool calls are billed to the agent's credit balance under its stored budget — a shortfall or an exhausted cap comes back as a tool result with `isError: true` and a JSON body (`insufficient_credits` / `budget_exceeded`). Stateless: no session ids, POST only. Send `Accept: application/json, text/event-stream`; responses stream as SSE.

List inbound emails

Get a specific inbound email

List inbound SMS messages

Get a specific inbound SMS

Returns a `soul_key` (shown only once) used as the bearer token for seller dashboard endpoints.

Browse all souls (legacy)

Browse souls with pagination

Search souls

Get standard service type taxonomy

Get service templates

Marketplace statistics

Reserved sub-paths (`browse`, `search`, `service-types`, `templates`, `stats`, `register`) are matched first.

Quote-to-Pay. Buys a copy of the soul's soul.md document.

Quote-to-Pay. Pays the soul's service price and executes the service. Returns an async job.

Get service job status (buyer view)

Rate a completed service execution

List job output files

Download a job output file

Update soul.md

Update soul.md price

List my services

Create a service

Update a service

Disable a service

List jobs as seller

Get job detail (seller view)

Get seller earnings balance

Request a payout

Link a wallet for payouts

Quote-to-Pay. Creates a multi-step orchestration goal that uses tools autonomously to reach an objective.

Get goal status

List tasks under a goal

Get budget status

Cancel a goal

Pause a recurring goal

Resume a paused goal

Quote-to-Pay.

Human-in-the-loop response

Spend breakdown by tool category

Return-on-compute-spend

List receipts

Tag a receipt with business value

Attribute a GTM outcome (reply, booked meeting, closed deal) to a whole cadence in one call, instead of one tagReceiptValue per receipt. Upserts on (agent, goal_id, type). Stored "pending" until the judge confirms.

Per-cadence RoCS rollup (spend vs. value grouped by goalId)

Returns the authenticated agent's append-only receipt log in oldest-first order. Pagination uses an opaque `(created_at, id)` cursor: pass `next_cursor` as `cursor` on the next request.

Poll the result of any async tool call. Returns the final result when `status` is `completed`.

Requires a fresh signed wallet read proof. Retains accepted request keys for at least 24 hours, including during admission rollback. A 404 is not proof that an in-flight submission cannot still be accepted.

Dependency health, separate from process liveness

Stripe Agent Commerce Protocol — describes the seller and products.

Create a checkout session

Retrieve a checkout session

Update a checkout session

Complete and pay for a session

Cancel a checkout session

Service health check

Public service statistics