Fyrmo
Small businesses in Costa Rica, Panama, Guatemala and Dominican Republic: WhatsApp, phone, email
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"fyrmo": {
"url": "https://www.fyrmo.com/api/mcp"
}
}
}リモートエンドポイント
https://www.fyrmo.com/api/mcpstreamable-httpできること
ツール一覧
ツール(12)
🟢list_categories(industry)
Every industry and category slug Fyrmo uses, with its English and Spanish name and how many businesses it has (Costa Rica and Panama together). Use the slugs as industry and category in the other tools. No credits, works without a key.
入力スキーマ
{
"type": "object",
"properties": {
"industry": {
"description": "Only this industry's categories",
"type": "string",
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_businesses(country, industry, category, place, channel, ...)
Search businesses in Costa Rica (or Panama with country: 'PA', Guatemala with 'GT', the Dominican Republic with 'DO') by industry, category, place, name and contact channel. Costs no credits: says which contacts each business has without revealing them, sorted by record quality. Combine industry and place with website, social, booking, min_rooms, email_type, ad_pixel, online_store, built_with and outdated_site to find the right target (spas that book on WhatsApp, businesses on Instagram with no website, stores that use Gmail, Wix sites not updated in years). Each result has signals with the same words: website, social, booking, booking_systems, rooms, email_type, ad_pixels, online_store, built_with, site_year (last update), no_mobile_version, no_https and opening_hours (OpenStreetMap format). Returns total and next_offset (null on the last page). Up to 3,000 results a day (100 until the account buys credits) and the first 1,000 of each search. detail: 'summary' drops signals and categories to save tokens.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)",
"type": "string",
"enum": [
"CR",
"PA",
"GT",
"DO"
]
},
"industry": {
"description": "Industry: tienda (Retail and convenience stores), restaurante (Restaurants and cafés), hospedaje (Hotels and lodging), automotriz (Auto repair and parts), salon_belleza (Beauty salons and barbers), gimnasio (Gyms and fitness), spa (Spas), salud (Clinics, doctors and labs), veterinaria (Veterinary clinics), educacion (Private schools and academies), servicios (Professional services), construccion_hogar (Construction and home services), eventos (Events and parties), industria (Manufacturers and distributors), agro (Farms and agriculture), imprenta_medios (Printing, signs and media), transporte (Transport, freight and car rental), entretenimiento (Entertainment, sports and recreation), finanzas (Banks, lenders and credit unions), otros (Other businesses)",
"type": "string",
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
]
},
"category": {
"description": "Category slug inside the industry, e.g. barberia, odontologia, pulperia_minisuper, taller_mecanico, hotel. list_categories has them all; an unknown one comes back with the valid ones",
"type": "string",
"maxLength": 40
},
"place": {
"description": "Province, canton or district in Costa Rica (e.g. 'Escazú', 'La Fortuna', 'Heredia'); in Panama, province, district or corregimiento (e.g. 'Chiriquí', 'David', 'Bella Vista'); in Guatemala, department or municipality (e.g. 'Quetzaltenango', 'Mixco'); in the Dominican Republic, province or municipality (e.g. 'La Vega', 'Santo Domingo Este'). Accents optional",
"type": "string",
"maxLength": 80
},
"channel": {
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)",
"type": "string",
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
]
},
"independent_only": {
"description": "true: small businesses only, no chain locations",
"type": "boolean"
},
"website": {
"description": "none: no website (or it is down or parked); has: a working website",
"type": "string",
"enum": [
"none",
"has"
]
},
"social": {
"description": "Only businesses with this social profile",
"type": "string",
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
]
},
"booking": {
"description": "How they take bookings: through WhatsApp, without a booking system (phone, email, form) or with one. Known for about 1,500 businesses, mostly spas, salons and hotels",
"type": "string",
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
]
},
"min_rooms": {
"description": "Hotels: at least this many rooms",
"type": "integer",
"minimum": 1,
"maximum": 2000
},
"email_type": {
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar",
"type": "string",
"enum": [
"own_domain",
"free"
]
},
"ad_pixel": {
"description": "true: its own website has a Meta or TikTok ad pixel",
"type": "boolean"
},
"online_store": {
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)",
"type": "boolean"
},
"built_with": {
"description": "Only businesses whose own website is built with this CMS or site builder",
"type": "string",
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
]
},
"outdated_site": {
"description": "true: its own website shows no update in two years or more (copyright year or page dates)",
"type": "boolean"
},
"name": {
"description": "Part of the business name",
"type": "string",
"maxLength": 120
},
"min_whatsapp_confidence": {
"description": "Minimum WhatsApp confidence, 0 to 1",
"type": "number",
"minimum": 0,
"maximum": 1
},
"limit": {
"description": "Results per page (max 50, default 20)",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Skip this many results (use next_offset)",
"type": "integer",
"minimum": 0,
"maximum": 999
},
"detail": {
"description": "full (default) or summary",
"type": "string",
"enum": [
"full",
"summary"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quote_list(country, industry, category, place, channel, ...)
Prices a list before buying it. Takes the same filters as search_businesses plus how many businesses you want (up to 200) and says how many match, how many of the first `count` with contacts you already revealed (free again) and how many credits the rest would cost, with a 10-row sample. Spends no credits. Show the person the price, then call build_list with the same filters.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)",
"type": "string",
"enum": [
"CR",
"PA",
"GT",
"DO"
]
},
"industry": {
"description": "Industry slug, named in search_businesses and list_categories",
"type": "string",
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
]
},
"category": {
"description": "Category slug inside the industry, e.g. barberia, odontologia, pulperia_minisuper, taller_mecanico, hotel. list_categories has them all; an unknown one comes back with the valid ones",
"type": "string",
"maxLength": 40
},
"place": {
"description": "Province, canton or district in Costa Rica (e.g. 'Escazú', 'La Fortuna', 'Heredia'); in Panama, province, district or corregimiento (e.g. 'Chiriquí', 'David', 'Bella Vista'); in Guatemala, department or municipality (e.g. 'Quetzaltenango', 'Mixco'); in the Dominican Republic, province or municipality (e.g. 'La Vega', 'Santo Domingo Este'). Accents optional",
"type": "string",
"maxLength": 80
},
"channel": {
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)",
"type": "string",
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
]
},
"independent_only": {
"description": "true: small businesses only, no chain locations",
"type": "boolean"
},
"website": {
"description": "none: no website (or it is down or parked); has: a working website",
"type": "string",
"enum": [
"none",
"has"
]
},
"social": {
"description": "Only businesses with this social profile",
"type": "string",
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
]
},
"booking": {
"description": "How they take bookings: through WhatsApp, without a booking system (phone, email, form) or with one. Known for about 1,500 businesses, mostly spas, salons and hotels",
"type": "string",
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
]
},
"min_rooms": {
"description": "Hotels: at least this many rooms",
"type": "integer",
"minimum": 1,
"maximum": 2000
},
"email_type": {
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar",
"type": "string",
"enum": [
"own_domain",
"free"
]
},
"ad_pixel": {
"description": "true: its own website has a Meta or TikTok ad pixel",
"type": "boolean"
},
"online_store": {
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)",
"type": "boolean"
},
"built_with": {
"description": "Only businesses whose own website is built with this CMS or site builder",
"type": "string",
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
]
},
"outdated_site": {
"description": "true: its own website shows no update in two years or more (copyright year or page dates)",
"type": "boolean"
},
"name": {
"description": "Part of the business name",
"type": "string",
"maxLength": 120
},
"min_whatsapp_confidence": {
"description": "Minimum WhatsApp confidence, 0 to 1",
"type": "number",
"minimum": 0,
"maximum": 1
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "How many businesses the list should have (max 200)"
}
},
"required": [
"count"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴build_list(country, industry, category, place, channel, ...)
Buys the list priced with quote_list: same filters and count, plus max_credits, the most the person agreed to spend. Reveals the businesses in order of record quality, never spends more than max_credits (businesses already revealed come free) and returns one row per business (WhatsApp with its wa.me link, mobile, phone, email, website, place, when the contact was last seen) plus a receipt: delivered, charged, free, how many have WhatsApp, credits per WhatsApp and credits left. Only businesses with at least one contact are listed; to pay only for WhatsApp, set channel: 'whatsapp'.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)",
"type": "string",
"enum": [
"CR",
"PA",
"GT",
"DO"
]
},
"industry": {
"description": "Industry slug, named in search_businesses and list_categories",
"type": "string",
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
]
},
"category": {
"description": "Category slug inside the industry, e.g. barberia, odontologia, pulperia_minisuper, taller_mecanico, hotel. list_categories has them all; an unknown one comes back with the valid ones",
"type": "string",
"maxLength": 40
},
"place": {
"description": "Province, canton or district in Costa Rica (e.g. 'Escazú', 'La Fortuna', 'Heredia'); in Panama, province, district or corregimiento (e.g. 'Chiriquí', 'David', 'Bella Vista'); in Guatemala, department or municipality (e.g. 'Quetzaltenango', 'Mixco'); in the Dominican Republic, province or municipality (e.g. 'La Vega', 'Santo Domingo Este'). Accents optional",
"type": "string",
"maxLength": 80
},
"channel": {
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)",
"type": "string",
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
]
},
"independent_only": {
"description": "true: small businesses only, no chain locations",
"type": "boolean"
},
"website": {
"description": "none: no website (or it is down or parked); has: a working website",
"type": "string",
"enum": [
"none",
"has"
]
},
"social": {
"description": "Only businesses with this social profile",
"type": "string",
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
]
},
"booking": {
"description": "How they take bookings: through WhatsApp, without a booking system (phone, email, form) or with one. Known for about 1,500 businesses, mostly spas, salons and hotels",
"type": "string",
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
]
},
"min_rooms": {
"description": "Hotels: at least this many rooms",
"type": "integer",
"minimum": 1,
"maximum": 2000
},
"email_type": {
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar",
"type": "string",
"enum": [
"own_domain",
"free"
]
},
"ad_pixel": {
"description": "true: its own website has a Meta or TikTok ad pixel",
"type": "boolean"
},
"online_store": {
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)",
"type": "boolean"
},
"built_with": {
"description": "Only businesses whose own website is built with this CMS or site builder",
"type": "string",
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
]
},
"outdated_site": {
"description": "true: its own website shows no update in two years or more (copyright year or page dates)",
"type": "boolean"
},
"name": {
"description": "Part of the business name",
"type": "string",
"maxLength": 120
},
"min_whatsapp_confidence": {
"description": "Minimum WhatsApp confidence, 0 to 1",
"type": "number",
"minimum": 0,
"maximum": 1
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "How many businesses the list should have (max 200)"
},
"max_credits": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "The most credits the person agreed to spend in this call"
}
},
"required": [
"count",
"max_credits"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢size_segments(segments)
How many businesses each segment has and how many of them have WhatsApp, without listing them. No credits, and doesn't count toward the daily search results. Use it to choose who to target before searching: e.g. for someone who sells espresso machines, compare cafés, bakeries, hotels and restaurants in a place. A segment takes the same filters as search_businesses. Up to 6 segments per call; results come back in the same order.
入力スキーマ
{
"type": "object",
"properties": {
"segments": {
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)",
"type": "string",
"enum": [
"CR",
"PA",
"GT",
"DO"
]
},
"industry": {
"description": "Industry slug, named in search_businesses and list_categories",
"type": "string",
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
]
},
"category": {
"description": "Category slug inside the industry, e.g. barberia, odontologia, pulperia_minisuper, taller_mecanico, hotel. list_categories has them all; an unknown one comes back with the valid ones",
"type": "string",
"maxLength": 40
},
"place": {
"description": "Province, canton or district in Costa Rica (e.g. 'Escazú', 'La Fortuna', 'Heredia'); in Panama, province, district or corregimiento (e.g. 'Chiriquí', 'David', 'Bella Vista'); in Guatemala, department or municipality (e.g. 'Quetzaltenango', 'Mixco'); in the Dominican Republic, province or municipality (e.g. 'La Vega', 'Santo Domingo Este'). Accents optional",
"type": "string",
"maxLength": 80
},
"channel": {
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)",
"type": "string",
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
]
},
"independent_only": {
"description": "true: small businesses only, no chain locations",
"type": "boolean"
},
"website": {
"description": "none: no website (or it is down or parked); has: a working website",
"type": "string",
"enum": [
"none",
"has"
]
},
"social": {
"description": "Only businesses with this social profile",
"type": "string",
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
]
},
"booking": {
"description": "How they take bookings: through WhatsApp, without a booking system (phone, email, form) or with one. Known for about 1,500 businesses, mostly spas, salons and hotels",
"type": "string",
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
]
},
"min_rooms": {
"description": "Hotels: at least this many rooms",
"type": "integer",
"minimum": 1,
"maximum": 2000
},
"email_type": {
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar",
"type": "string",
"enum": [
"own_domain",
"free"
]
},
"ad_pixel": {
"description": "true: its own website has a Meta or TikTok ad pixel",
"type": "boolean"
},
"online_store": {
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)",
"type": "boolean"
},
"built_with": {
"description": "Only businesses whose own website is built with this CMS or site builder",
"type": "string",
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
]
},
"outdated_site": {
"description": "true: its own website shows no update in two years or more (copyright year or page dates)",
"type": "boolean"
}
}
},
"description": "The segments to compare"
}
},
"required": [
"segments"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_business(code, codes)
The full record of one business (code) or up to 10 (codes): location, description, opening hours (OpenStreetMap format), its website in detail (what it is built with, last update, https, mobile version, online store, booking system, travel sites, delivery apps, payments, chat, analytics and ad pixels), social profiles, attributes with their source (services, prices, how it takes bookings) and its contacts. No credits, up to 300 a day (20 until the account buys credits); revealed ones don't count. Contacts stay masked and social profiles hidden (value null, hidden true) until revealed.
入力スキーマ
{
"type": "object",
"properties": {
"code": {
"description": "Business code, from search_businesses",
"type": "string",
"minLength": 6,
"maxLength": 32
},
"codes": {
"description": "Several codes at once (max 10)",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 6,
"maxLength": 32
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢find_similar(code, limit)
Businesses like a given one: same industry, categories in common, nearby (same canton, then province) and the same signals (website, Instagram/TikTok, how they book, independent). Use it to grow a list from a business that worked. No credits; counts toward the daily search results; contacts are not shown.
入力スキーマ
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 6,
"maxLength": 32,
"description": "Business code to start from"
},
"limit": {
"description": "How many (max 50, default 20)",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢match_list(rows)
Finds which businesses of a list the person already has (a CRM export, a spreadsheet) are in Fyrmo. Each row matches by phone, email or own website, or by exact name plus canton or district; a phone or website shared by several businesses (a chain, a directory) only counts when the name tells them apart. Returns, per row (0-based), the business code and what it matched by, or why not (no_data, not_found, ambiguous, daily_limit), plus the matched businesses without their contacts. No credits; counts toward the daily search results; reveal the ones they want with reveal_contacts. Up to 200 rows per call. The list is not stored.
入力スキーマ
{
"type": "object",
"properties": {
"rows": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"description": "Business name",
"type": "string",
"maxLength": 200
},
"phone": {
"description": "Phone, mobile or WhatsApp in any format; several separated by /",
"type": "string",
"maxLength": 200
},
"website": {
"description": "Website or domain",
"type": "string",
"maxLength": 300
},
"email": {
"type": "string",
"maxLength": 200
},
"place": {
"description": "Canton or district, e.g. 'Escazú'",
"type": "string",
"maxLength": 100
}
}
}
}
},
"required": [
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reveal_contacts(codes)
Returns the WhatsApp, mobile, phone and email of up to 50 businesses, each with its confidence, sources and last-seen date, and a wa.me link for every WhatsApp or mobile so the person can write one to one (their social profiles then show in get_business). Costs 1 credit per new business; businesses already revealed (12 months) and businesses without contacts are not charged. Limit: 500 per day.
入力スキーマ
{
"type": "object",
"properties": {
"codes": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 6,
"maxLength": 32
},
"description": "Business codes"
}
},
"required": [
"codes"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡report_outcome(code, outcome, contact, note)
Records how the contact with a revealed business went. wrong_number and closed give the credit back (within 14 days, up to 10% of what was revealed that month) and send the business back to research. Use note 'do not contact' when a business asks not to be written to again.
入力スキーマ
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 6,
"maxLength": 32
},
"outcome": {
"type": "string",
"enum": [
"worked",
"no_answer",
"wrong_number",
"not_whatsapp",
"closed"
]
},
"contact": {
"description": "The number or email used; defaults to the main contact",
"type": "string",
"maxLength": 200
},
"note": {
"type": "string",
"maxLength": 500
}
},
"required": [
"code",
"outcome"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢my_contacts(status, limit, offset)
The businesses you revealed with their contacts and wa.me links, the last outcome you reported and when the reveal expires (after that the contacts come back masked until revealed again), plus your balance.
入力スキーマ
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"all",
"not_contacted",
"contacted"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢buy_credits
Credit packs (100 = US$29, 500 = US$119, 2,000 = US$399, 10,000 = US$1,490) with their Stripe payment link. The link carries the client number, so credits load on their own once the payment completes. Give the link to the person as is; Fyrmo never asks for card details here.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス