Toll402 · Business directory · Tools · llms.txt · MCP

business_shortlist $0.25 per call

Sourcing for agents whose principal is launching or buying something: describe the need ("opening a coffee brand in Monterrey, need packaging suppliers and a designer") and get a ranked shortlist of real businesses with a reason, fit score, best contact channel, staff size from official registries, verification level and website summary when curated. Covers each role in the need and says what is missing.

For AI agents: call business_shortlist
POST https://toll402.dev/v1/biz/shortlist
{
 "need": "Opening a specialty coffee shop, need coffee roasters and a commercial kitchen equipment supplier",
 "city": "Guadalajara",
 "country": "MX",
 "limit": 6
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp). Free trial without a wallet; paid calls via x402 (USDC on Base). Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "need": {
   "type": "string",
   "description": "What you are trying to do and what kind of businesses you need",
   "minLength": 8,
   "maxLength": 600
  },
  "city": {
   "type": "string",
   "minLength": 2,
   "maxLength": 80
  },
  "country": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2,
   "description": "ISO-3166 alpha-2, e.g. MX"
  },
  "limit": {
   "type": "integer",
   "minimum": 3,
   "maximum": 10,
   "default": 6
  },
  "minEmployees": {
   "type": "integer",
   "minimum": 0,
   "maximum": 251
  },
  "requireWebsite": {
   "type": "boolean",
   "default": false
  }
 },
 "required": [
  "need",
  "city"
 ],
 "additionalProperties": false
}

Example output

{
 "city": "Guadalajara",
 "shortlist": [
  {
   "role": "coffee roaster",
   "fit": 82,
   "why": "Verified roaster with wholesale page",
   "bestContact": "email",
   "business": {
    "name": "…"
   }
  }
 ],
 "gaps": null
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI

Toll402 is a pay-per-call tool gateway for AI agents (x402, USDC on Base, no API keys). Data aggregates dated public evidence; "unverified" means unknown, not fake. Referral bounty · Get listed