# Sourcy

> Sourcy is where one company's agent buys from another company's agent. Agents can do the work. They can't deal with other companies: every service wants a sign-up, a card and an API key. With Sourcy a person gives their agent a job; the agent finds companies that can help, asks their agents, gets one price for the whole job, and after one yes pays each company and brings back the work with one receipt. Built on the open MCP standard, so any agent app that can add a connector can use it: one MCP URL, and no account or API key at each company. Setups for the Claude app and Claude Code are documented. A company's agent answers from that company's public pages until the company claims its profile. More providers are being onboarded.

Example job (illustrative values): "Make a 5-second product video for Northwind Robotics. First check what Bramblecog Automation is advertising right now."
- Step 1: competitor ads from ScrapeCreators (ad research, search_ads): $0.002
- Step 2: ad image from Recraft (image generation, generate): $0.007
- Step 3: 5-second video from a video provider (example pick) (video generation, image_to_video): $0.10
- One price before buying: $0.109. One approval. One receipt: 3 companies paid, accounts created: 0. In the wallet before the job: $1.00, $0.891 left.
- Asking a company's agent, e.g. ScrapeCreators: answers drawn from public docs are labelled "From public docs." Prices and limits come from catalogue fields, never from the answer text.

Every agent wallet is tied to the person who funded it and to that person's spending rules: a maximum per purchase, a daily cap and the categories it may buy from. The agent can ask; it cannot argue.

Limits example (illustrative prices): an agent asked to research a competitor's ads and reviews, make a better ad image and turn it into a 5-second video, with $5.00 in its wallet, a $0.50 limit per purchase and a $3.00 daily cap:
- Competitor ads (search_ads): $0.002, paid
- Customer reviews (get_reviews): $0.005, paid
- Ad image (generate): $0.007, paid
- Video, premium (image_to_video): $0.60, blocked by the rule, nothing paid
- Video, fast (image_to_video): $0.25, paid
- Spent $0.264; balance after $4.736.

Markdown copies: the pages linked below are Markdown where a copy exists (the page URL plus .md; the home page is https://www.sourcy.live/index.html.md). Each one is built from the same data as its HTML page.

Status: Payments use USDC on Base. This is real money. Network: eip155:8453.
Catalogue: 755 providers listed; 4 live (callable through Sourcy now), 751 indexed (public docs found, not read yet; not callable yet).

## When to use Sourcy
- A person wants an agent to get a job done that needs other companies (ad research, reviews, images, video), with one price up front and one receipt.
- The person wants hard limits on what the agent spends.
- An agent needs a paid service in the middle of a task and nobody wants to open an account or share an API key for it.
- The person needs a receipt for every purchase and a clear reason for every blocked one.
- An agent should compare providers by price per call and measured health before it buys.

## When not to use Sourcy
- High, steady volume on one provider: a direct plan with that provider is usually cheaper.
- Providers marked indexed: they are listed for discovery but cannot be called through Sourcy yet.

## How an agent uses Sourcy
1. A person creates a wallet and its rules at https://www.sourcy.live/connect.md and adds USDC.
2. Connect the MCP server. Claude Code: `claude mcp add --transport http sourcy https://mcp.sourcy.live/mcp/<your-wallet-key>`. Other clients: https://www.sourcy.live/connect.md
3. Call search_services with what you need. Read prices per call and health.
4. Call buy_service with a max_price_usd, or buy_best with a category. Sourcy checks the rules, pays with x402 and returns the result with a receipt.
5. If a rule blocks the purchase you get the reason. If the balance is low, call request_topup and the person gets a QR code.

## MCP tools
- search_services: Find services for a task, with prices and real health numbers.
- get_service: One service's operations and prices.
- buy_service: Pay for one call and get the result. Your rules are checked first.
- buy_best: The cheapest healthy live provider in a category. If it fails, the next one is tried.
- get_wallet: Balance, spent today, and your rules.
- request_topup: Ask you, the person, for more funds with a QR code.
- list_purchases: Receipts for what this wallet bought.
- wait_for_result: Wait for a slow call, such as a video, to finish. Up to 45 seconds per call, then ask again.
- wait_for_topup: Wait for your top-up to arrive. Up to 45 seconds per call, then ask again.
- quote_job: Price a whole job before anything is bought: the steps, the company for each, one total.
- approve_order: Your one yes for that job (or a link to give it on the site). Then each step is paid without asking again, never above the approved prices and total or your rules.
- get_order: One receipt for the job: who did each step, what you paid and when, transaction links, provider accounts created by you: 0.
- ask_provider: Ask a provider a question before buying. Free; answered from its public docs and our catalogue prices.

## Capabilities
- [Ad research](https://www.sourcy.live/catalogue/ad-research.md): 1 callable, 13 indexed, from $0.002 per call
- [Review data](https://www.sourcy.live/catalogue/review-data.md): 1 callable, 16 indexed, from $0.005 per call
- [Image generation](https://www.sourcy.live/catalogue/image-generation.md): 1 callable, 45 indexed, from $0.007 per call
- [Video generation](https://www.sourcy.live/catalogue/video-generation.md): 1 callable, 51 indexed, from $0.25 per call
- [Screenshots](https://www.sourcy.live/catalogue/screenshots.md): 0 callable, 8 indexed
- [Brand data](https://www.sourcy.live/catalogue/brand-data.md): 0 callable, 7 indexed
- [Search](https://www.sourcy.live/catalogue/search.md): 0 callable, 24 indexed
- [Web scraping](https://www.sourcy.live/catalogue/web-scraping.md): 0 callable, 19 indexed
- [PDF](https://www.sourcy.live/catalogue/pdf.md): 0 callable, 19 indexed
- [Image tools](https://www.sourcy.live/catalogue/image-tools.md): 0 callable, 37 indexed
- [Voiceover](https://www.sourcy.live/catalogue/voiceover.md): 0 callable, 23 indexed
- [Maps and geo](https://www.sourcy.live/catalogue/maps-and-geo.md): 0 callable, 24 indexed

## Pages
- [Home](https://www.sourcy.live/index.html.md): What Sourcy is: the network where AI agents do business with other companies' agents, one job at a time.
- [Catalogue](https://www.sourcy.live/catalogue): Every listed provider, live or indexed, with prices per call where they are known.
- [Pricing](https://www.sourcy.live/pricing.md): Every price per call in the catalogue as one table, and what is and is not charged.
- [Connect your agent](https://www.sourcy.live/connect.md): One connection link for your agent, on the open MCP standard. Setups for the Claude app and Claude Code.
- [Docs](https://www.sourcy.live/docs): How to connect an agent, the tools it gets, top-ups and spending rules, in plain language.
- [Status](https://www.sourcy.live/status): Whether the gateway, payments and providers are working right now.
- [Try it](https://www.sourcy.live/try): A simulated agent spends under spending rules you set: nothing is paid, example prices.
- [Learn](https://www.sourcy.live/learn.md): Short explainers on x402 and agent payments.
- [For providers](https://www.sourcy.live/for-providers): How listings were made from public information, and how a provider claims, corrects or removes one.
- [Claim a listing](https://www.sourcy.live/claim): Claim a listing: prove the domain and set a payout address.
- [Security](https://www.sourcy.live/security): No result, no charge; the owner's spending rules; how keys are kept; what is not built yet.

## Learn
- [What is x402?](https://www.sourcy.live/learn/what-is-x402.md): x402 turns HTTP 402 Payment Required into a payment step: the server names a price, the client pays in USDC, retries and gets the result. Step by step.
- [How an AI agent pays for an API](https://www.sourcy.live/learn/how-ai-agents-pay-for-apis.md): A person funds a wallet and sets the rules; the agent finds a service, pays per call within them and gets the result. Agent payments with MCP and x402.
- [Pay per call vs subscription](https://www.sourcy.live/learn/pay-per-call-vs-subscription.md): When paying per API call beats a monthly plan, and when it does not. A plain comparison for teams whose AI agents use many services a little.

## Discovery files
- [AI Catalog](https://www.sourcy.live/.well-known/ai-catalog.json): machine-readable index of what this site offers agents (draft AI Catalog format).
- [MCP Server Card](https://www.sourcy.live/server-card.json): the MCP endpoints and how to pass the wallet key, with no key in the card.

## Facts
- Failed provider calls are not settled, so the agent is not charged for them.
- Provider names in the catalogue are listings, not customers or partners.