Sami Swoi
Directory of Polish-run businesses outside Poland: shops, tradespeople, doctors, services.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~2,127Tokens (definiciones de herramientas)
~5.0 KBTamaño de respuesta típico
Impacto moderado en la atención (1.66% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"firmy": {
"url": "https://samiswoi.app/mcp"
}
}
}Puntos de conexión remotos
https://samiswoi.app/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (4)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search_companies(country, city, category, query, limit, ...)
Search Polish-run businesses outside Poland listed on Sami Swoi (samiswoi.app), for questions like "Polish plumber in London", "Polish shop in Utrecht", "Polish dentist in Oslo", "polska księgowa w Dublinie". Filters: country, city, category (slug or Polish word, see list_categories) and a phrase from the name or kind of business. Returns up to 20 businesses per call (page with offset/next_offset), each with city, category and its samiswoi.app page, plus the total. / Polskie firmy za granicą: kraj, miasto, kategoria, fraza.
Esquema de entrada
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Country: ISO code (\"GB\", \"DE\", \"NL\") or name in Polish or English (\"Holandia\", \"Germany\"). / Kraj."
},
"city": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "City, e.g. \"London\", \"Londyn\", \"Utrecht\". Best together with country. / Miasto."
},
"category": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Category slug from list_categories (e.g. \"hydraulik\", \"sklep-spozywczy\") or a Polish word (\"dentysta\", \"fryzjer\"). / Kategoria."
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Words from the business name or kind, Polish works best (\"delikatesy\", \"mechanik\", \"Biedronka\"). / Fraza."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10,
"description": "Maximum results (1-20, default 10)."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 2000,
"default": 0,
"description": "Skip this many matches; use next_offset."
}
},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_companies",
"country_not_found",
"category_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"description": "Filters as applied.",
"additionalProperties": true
},
"total_found": {
"type": "integer"
},
"returned": {
"type": "integer"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Company id (address on samiswoi.app); use with get_company."
},
"name": {
"type": "string"
},
"category": {
"type": "string",
"description": "Category slug (see list_categories)."
},
"category_label": {
"type": "string",
"description": "Category name in Polish."
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2."
},
"country": {
"type": "string",
"description": "Country name in Polish."
},
"city": {
"type": "string"
},
"managed_by_owner": {
"type": "boolean",
"description": "true = the owner runs this profile; false = built from public data, not yet claimed."
},
"url": {
"type": "string",
"description": "Company page on samiswoi.app (contact details, map)."
}
},
"required": [
"id",
"name",
"category",
"category_label",
"country_code",
"country",
"city",
"managed_by_owner",
"url"
],
"additionalProperties": false
}
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"value",
"name"
],
"additionalProperties": false
}
},
"next_offset": {
"type": "integer"
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢get_company(id, url)
One Polish business abroad on Sami Swoi by its id or samiswoi.app page URL: category, city and country, address, website, languages, opening hours, short description and the data source. Phone and e-mail are on the linked page. / Profil jednej firmy.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 3,
"maxLength": 40,
"description": "Company id from search_companies, e.g. \"polski-sklep-utrecht\"."
},
"url": {
"type": "string",
"minLength": 10,
"maxLength": 200,
"description": "Company page URL, e.g. https://samiswoi.app/polski-sklep-utrecht"
}
},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Company id (address on samiswoi.app); use with get_company."
},
"name": {
"type": "string"
},
"category": {
"type": "string",
"description": "Category slug (see list_categories)."
},
"category_label": {
"type": "string",
"description": "Category name in Polish."
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2."
},
"country": {
"type": "string",
"description": "Country name in Polish."
},
"city": {
"type": "string"
},
"managed_by_owner": {
"type": "boolean",
"description": "true = the owner runs this profile; false = built from public data, not yet claimed."
},
"url": {
"type": "string",
"description": "Company page on samiswoi.app (contact details, map)."
},
"description": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"object",
"null"
],
"properties": {
"street": {
"type": [
"string",
"null"
]
},
"postcode": {
"type": [
"string",
"null"
]
},
"city": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"street",
"postcode",
"city",
"country"
],
"additionalProperties": false
},
"website": {
"type": [
"string",
"null"
]
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Languages spoken (always includes Polish)."
},
"opening_hours": {
"type": "array",
"items": {
"type": "string"
},
"description": "e.g. \"Mon 09:00-17:00\"; empty when unknown."
},
"source": {
"type": "string",
"description": "Where the data comes from."
},
"country_url": {
"type": "string"
},
"category_url": {
"type": "string"
},
"city_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"category",
"category_label",
"country_code",
"country",
"city",
"managed_by_owner",
"url",
"description",
"address",
"website",
"languages",
"opening_hours",
"source",
"country_url",
"category_url",
"city_url"
],
"additionalProperties": false
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢list_countries
Countries with Polish businesses listed on Sami Swoi: ISO code, Polish name, number of businesses and the country page. / Kraje i liczba polskich firm.
Esquema de entrada
{
"type": "object",
"properties": {},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"total_companies": {
"type": "integer"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"companies": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"code",
"name",
"companies",
"url"
],
"additionalProperties": false
}
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢list_categories(country)
Business categories used by Sami Swoi (slug, Polish name, group, number of listed businesses) for the category filter of search_companies. Optional country limits the counts to one country. / Kategorie firm.
Esquema de entrada
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Country: ISO code (\"GB\", \"DE\", \"NL\") or name in Polish or English (\"Holandia\", \"Germany\"). / Kraj."
}
},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"country_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"group": {
"type": "string"
},
"companies": {
"type": "integer"
}
},
"required": [
"slug",
"name",
"group",
"companies"
],
"additionalProperties": false
}
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada4 herramientas