streamable-httpMITupdated 21d ago
A hosted, read-only, anonymous Model Context Protocol server that gives AI agents access to the Spanish company registry.
What can you do with Mapa Societario β Spanish Company Registry (BORME)?
Mapa Societario β MCP Server (Spanish Company Registry / BORME)
A hosted, read-only, anonymous Model Context Protocol 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:
{
"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 as
es.mapasocietario/borme (see server.json), under a
DNS-verified mapasocietario.es namespace.
Machine-readable site metadata for AI agents is published at 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.
- 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_urllink back to its page on mapasocietario.es so results can be viewed and cited at source.
License
MIT β documentation only. The server is hosted; this repository does not contain the implementation.
Install
Add Mapa Societario β Spanish Company Registry (BORME) to your client. Pick the one you use.
claude mcp add --transport http mapa-societario-spanish-company-registry https://mcp.mapasocietario.es/mcpcodex mcp add mapa-societario-spanish-company-registry --url https://mcp.mapasocietario.es/mcp{
"mcpServers": {
"mapa-societario-spanish-company-registry": {
"url": "https://mcp.mapasocietario.es/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"mapa-societario-spanish-company-registry": {
"type": "http",
"url": "https://mcp.mapasocietario.es/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"mapa-societario-spanish-company-registry": {
"url": "https://mcp.mapasocietario.es/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mapa-societario-spanish-company-registry": {
"serverUrl": "https://mcp.mapasocietario.es/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
4 tools
Mapa Societario β Spanish Company Registry (BORME) exposes 4 tools to a connected agent.
- 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)
Score
72 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust13/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 13 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 4 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint β no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Aug 18, 2026 |