For AI agents: this page in Markdown · llms.txt
API and MCP server
Search the Requstory Index of B2B suppliers, read their dated trade facts and send quote requests from your AI agent. No key, no sign-in.
The Requstory Index: suppliers for buying agents
The Index lists independent B2B suppliers (wholesalers, distributors and manufacturers in the UK and US). Each listing has trade facts read from the supplier's own website, each dated: prices shown or quote on request (or a trade login), minimum order with its amount, payment terms, delivery and returns policies and the trade account link. Verified listings were confirmed by the owner and come first. No key needed.
Flow: search_suppliers with a product type ("compostable cups", "M8 bolts") and filters (country GB or US, prices shown or quote, maxMinimumOrder, payOnAccount, verifiedOnly), then get_supplier for the full facts of one supplier, and request_quote with the supplier, the items, quantity, where to deliver and the buyer's name and email. The supplier gets the request by email and replies to the buyer; nothing is ordered or paid. Share the buyer's details only with their consent.
REST: GET /api/public/v1/suppliers?q=packaging&country=GB and POST /api/public/v1/suppliers/{supplier}/quotes with items, quantity, deliverTo, buyerName, buyerEmail, buyerCompany and message. Quote requests are limited to 10 an hour per caller.
MCP server
Remote MCP server (Streamable HTTP): https://requstory.com/mcp. In Claude: Settings, Connectors, Add custom connector, and paste the address. The tools work straight away, with no sign-in. Discovery file: https://requstory.com/.well-known/mcp.json
| Tool | What it does | Sign-in |
|---|---|---|
| search_suppliers | Find B2B suppliers by product type, country, prices, minimum order and payment terms; dated facts. | No |
| get_supplier | One supplier's dated trade facts, its record with buyers and recent prices. | No |
| request_quote | Send a buyer's quote request to a supplier in the Index; the buyer confirms by email, then the supplier replies by email. | No |
REST API
Base URL: https://requstory.com/api/public/v1. JSON in and out. No key: 10 calls a minute. Errors look like {"error": {"code", "message"}}.
| Endpoint | What it does |
|---|---|
| GET /suppliers?q= | Search B2B suppliers in the Index by product type, country, prices, minimum order and payment terms. |
| GET /suppliers/{supplier} | One supplier's dated trade facts, its record with buyers and recent prices. |
| POST /suppliers/{supplier}/quotes | Send a buyer's quote request to one supplier. The buyer confirms by email first. |
| GET / | How many suppliers are listed and how many were added this week. |
Example
- curl 'https://requstory.com/api/public/v1/suppliers?q=paper+cups&country=GB&limit=5'
- curl https://requstory.com/api/public/v1/suppliers/<supplier>
- curl -X POST https://requstory.com/api/public/v1/suppliers/<supplier>/quotes -H 'Content-Type: application/json' -d '{"items":"12oz paper cups with lids","quantity":"2,000","deliverTo":"Leeds LS6, UK","buyerName":"Sam Lee","buyerEmail":"sam@example.co.uk"}'
Notes
- Facts marked source website were read from the supplier's own site on the date given; owner means the supplier confirmed them.
- Send a quote request only with the buyer's consent to share their name and email with that supplier. Nothing is ordered or paid.
- The Lab's tools (company maps, ease scores, AI readiness and the order-to-cash agents) are a separate MCP server: https://requstory.com/mcp/lab. Docs: https://requstory.com/lab/api/
- Questions: hello@requstory.com.