Mapa Societario — Spanish Company Registry (BORME)
Search Spanish companies and directors from the official BORME registry and map their links.
Open source Repository Open in the app JSON README (API)
About
Search Spanish companies and directors from the official BORME registry and map their links.
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- es.mapasocietario
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-08-18T14:19:37Z
- Repository state
- ativo
- Language
- Dockerfile
- License
- MIT
- Added
- 2026-08-29 03:01:32
- Updated
- 2026-08-29 03:01:32
- Origin id
es.mapasocietario/borme
README
# Mapa Societario — MCP Server (Spanish Company Registry / BORME)
A hosted, **read-only**, **anonymous** [Model Context Protocol](https://modelcontextprotocol.io)
server that gives AI agents access to the Spanish company registry.
It exposes data derived from the official **BORME** (Boletín Oficial del Registro
Mercantil / Registro Mercantil) — **~3.1M companies and ~9.4M filings since 2009** —
so an assistant can search companies and directors and explore corporate
relationships directly.
- 🔎 Web app: **https://mapasocietario.es**
- ☁️ Connector URL: **`https://mcp.mapasocietario.es/mcp`** (Streamable HTTP, JSON-RPC)
- 🔓 Auth: none · **Rate limit:** 30 requests/min, 1,000/day per IP
## Tools
| Tool | Description |
|------|-------------|
| `search_companies` | Search Spanish companies by name (typo-tolerant, ranked) |
| `get_company` | Full record for one company — current officers, sole shareholder, dissolution status, NIF/capital/address |
| `search_officers` | Search directors / officers by name (accent-insensitive) |
| `get_company_network` | Related companies and shared officers as a graph (`owns` / `owned_by` / `shared_officer` edges) |
## Connect
**Claude clients with native remote-MCP support** — add a custom connector with the URL:
```
https://mcp.mapasocietario.es/mcp
```
**Claude Desktop (or any client) via the `mcp-remote` bridge:**
```json
{
"mcpServers": {
"mapa-societario": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.mapasocietario.es/mcp"]
}
}
}
```
Health check: `curl -s https://mcp.mapasocietario.es/health` → `ok`.
## Registry listings
This server is published to the official
[MCP Registry](https://registry.modelcontextprotocol.io) as
**`es.mapasocietario/borme`** (see [`server.json`](server.json)), under a
DNS-verified `mapasocietario.es` namespace.
Machine-readable site metadata for AI agents is published at
[mapasocietario.es/llms.txt](https://mapasocietario.es/llms.txt).
## Data & limitations
- **Unofficial.** Derived from official BORME publications and provided **as-is**.
For documented or critical use, consult the official BORME and the company's
page on [mapasocietario.es](https://mapasocietario.es).
- **Ownership:** BORME records only the **sole shareholder** (*socio único*),
not full shareholder / cap-table data.
- **Out of scope:** sanctions / PEP screening, annual accounts (*Cuentas
Anuales*), AI analysis, and cross-company time-range / event queries.
- Every company result includes an `empresa_url` link back to its page on
mapasocietario.es so results can be viewed and cited at source.
## License
[MIT](LICENSE) — documentation only. The server is hosted; this repository does
not contain the implementation.