# Tokoo > Tokoo finds the real importers, buyers and distributors behind trade flows. Filter companies by HS code and country, check a company's trade record, and unlock buyer contacts (email or phone) with credits. Search is free. Unlocking a work email costs 1 credit and unlocking a phone number costs 10 credits (100 credits = $1). Amounts the API reports (credits_needed, charged, refunded, details.needed) are credits, not contacts. Always show the user the credit cost and get their agreement before unlocking. Never claim where the data comes from. ## Connect - MCP (recommended): https://www.tokoo.app/api/mcp (Streamable HTTP; OAuth sign-in, or an API key as a Bearer token) - REST: https://www.tokoo.app/api/v1 with "Authorization: Bearer "; keys at https://www.tokoo.app/app/developers - OpenAPI: https://www.tokoo.app/api/openapi.json ## MCP tools - search_hs_codes: product words to HS codes (free) - search_importers: importers of HS codes into countries, most shipments first (free) - search_companies: companies by name, country, role or HS codes (free) - get_company: one company profile (free) - get_trade_history: HS mix, shipments and counterparties over 24 months (free) - list_contacts: contacts at a company, masked until unlocked (free) - unlock_contacts: email or phone for up to 50 contacts at one company; call with confirm:false for the price first (paid) - get_credit_balance: credits left (free) ## Limits 60 requests/min per key, 10 unlock calls/min, 2,000 result rows/day per organisation. Errors are {"error":{"code","message","details"}}; 402 insufficient_credits carries details.needed and details.balance (credits); 429 carries Retry-After. ## Skills Agent skills (Claude Code and others): https://github.com/haijin/tokoo-skills