Skip to main content

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 is available through Stripe’s Agentic Commerce Protocol (ACP), which means any LLM agent with Stripe access — including ChatGPT, Claude, and custom agents — can discover and pay for OneShot tools using standard payment rails. No wallet setup, no USDC, no private keys. Just Stripe.

​
What you can buy

Every OneShot tool is available as an ACP product. Your agent discovers them automatically via the manifest endpoint.
ProductWhat it does
oneshot-emailSend emails from a custom domain with tracking
oneshot-smsSend SMS to one or many numbers
oneshot-voiceAI voice calls with an objective
oneshot-researchDeep web research on any topic
oneshot-buildGenerate a full production website
oneshot-enrich-emailFind someone’s email from name + company
oneshot-enrich-profileEnrich a profile from LinkedIn, email, or name
oneshot-verify-emailCheck if an email is deliverable
oneshot-commerce-searchSearch for products across e-commerce
oneshot-soul-*Custom AI services built by other agents
See Pricing for current costs. Some tools have dynamic pricing based on input — the exact price is returned when you create a checkout session.

​
How it works

1

Discover

Your agent fetches GET /.well-known/acp/manifest.json to see available products, prices, and input schemas. No auth required.
2

Create a session

POST /acp/checkout_sessions with the product ID and input parameters. OneShot returns a session with the exact price.
3

Pay and execute

POST /acp/checkout_sessions/:id/complete with a Stripe SharedPaymentToken. OneShot charges the token, executes the tool, and returns a request_id.
4

Get results

Poll GET /v1/requests/:request_id until the job completes. Results are returned inline.

​
Authentication

EndpointAuth
GET /.well-known/acp/manifest.jsonNone (public)
All /acp/checkout_sessions/*Bearer token + API version header
Authorization: Bearer {your_acp_token}
API-Version: 2026-01-30

​
ACP vs x402

OneShot supports two payment protocols. Use whichever fits your agent’s setup.
Stripe ACPx402 (Crypto)
Best forAgents with Stripe access (ChatGPT, etc.)Agents with a crypto wallet
PaymentUSD via Stripe SharedPaymentTokenUSDC or ETH on Base
Discovery/.well-known/acp/manifest.jsonSDK or API docs
SetupBearer tokenWallet private key
Both protocols give access to the same tools and deliver results the same way.

​
Quick example

Send a research request via ACP: 
# 1. Create session
curl -X POST https://win.oneshotagent.com/acp/checkout_sessions \
  -H "Authorization: Bearer $ACP_TOKEN" \
  -H "API-Version: 2026-01-30" \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [{
      "item": {
        "id": "oneshot-research",
        "metadata": { "topic": "Stripe ACP adoption trends 2026" }
      }
    }]
  }'

# 2. Complete with payment (use session ID from step 1)
curl -X POST https://win.oneshotagent.com/acp/checkout_sessions/{session_id}/complete \
  -H "Authorization: Bearer $ACP_TOKEN" \
  -H "API-Version: 2026-01-30" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_data": {
      "instrument": {
        "credential": { "token": "spt_live_..." }
      }
    }
  }'

# 3. Poll for results (use request_id from step 2)
curl https://win.oneshotagent.com/v1/requests/{request_id}
In development and staging, use mock tokens prefixed with spt_mock_ to skip real charges.