# Sami Swoi

> Sami Swoi is a free MCP server for local services. Free read-only MCP server to search Polish-run businesses outside Poland. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://samiswoi.app/asystenci-ai
- **MCP Registry name:** app.samiswoi/firmy
- **Categories:** local services
- **Listing updated:** 2026-11-15

## About

Behind the server is the Sami Swoi directory, which lists only Polish businesses operating abroad: shops, tradespeople, doctors and other services. A request like a Polish plumber in London goes through search_companies, which filters by country, city, category or free phrase.

A company profile returns category, city, address, website, languages, opening hours and data source. Phone numbers and email addresses are deliberately left out; they stay on the company's own page, which every result links to. The server returns only what is already published on samiswoi.app.

The endpoint is public Streamable HTTP with no sign-in and no charge. It is not in any app directory, so you add it by hand as a custom connector, and the site gives steps for Claude, Mistral Le Chat and Perplexity (Perplexity needs a paid plan for custom connectors). The operator says it stores neither queries nor IP addresses, only an anonymous daily call counter kept for 30 days.

## Features

- **Search by place and category:** Find businesses by country, city, category or phrase.
- **Company profiles:** Get address, website, languages, opening hours and source for one business.
- **Country and category lists:** Browse which countries and categories the directory covers.
- **No contact details returned:** Phone numbers and emails are withheld; results link to the company page.
- **No authentication:** Open endpoint with no account or key.

## Good for

- Find a Polish-speaking doctor in a given city abroad
- Look up Polish tradespeople for a home repair overseas
- See which countries have listed Polish businesses
- Check opening hours for a Polish shop abroad

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http firmy https://samiswoi.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://samiswoi.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "firmy": {
      "url": "https://samiswoi.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "firmy": {
      "type": "http",
      "url": "https://samiswoi.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "firmy": {
      "serverUrl": "https://samiswoi.app/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "firmy": {
      "type": "http",
      "url": "https://samiswoi.app/mcp"
    }
  }
}
```

## Tools

- `search_companies`: Searches businesses by country, city, category or phrase.
- `get_company`: Returns one company profile.
- `list_countries`: Lists countries and the number of Polish businesses in each.
- `list_categories`: Lists business categories for use as a search filter.

## FAQ

### Does it need an account?

No. It is public and read-only, with no authentication.

### Does it return phone numbers?

No. Phone numbers and email addresses are not returned; each result links to the company page.

### Is it in an app directory?

No. You add it yourself by pasting https://samiswoi.app/mcp as a custom connector.

### What does it log?

The operator says it does not store queries or IP addresses, only an anonymous daily call counter kept for 30 days.

### Is Sami Swoi free?

Yes. Sami Swoi is free to use.

### How do I add Sami Swoi to Claude Code?

Run this command in your terminal: claude mcp add --transport http firmy https://samiswoi.app/mcp

### What are the best alternatives to Sami Swoi?

The closest alternatives to Sami Swoi are Later Stages, Virkly CVR, MaineMCP, Renta and Tulsa Ecosystem Map.

## Alternatives

- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Virkly CVR](https://ai-powered.com/mcp/virkly-cvr): Virkly CVR is a free MCP server for local services.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [HALPII](https://ai-powered.com/mcp/halpii): HALPII is a free MCP server for home services.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/sami-swoi
