# BORME API

BORME API is an MCP server for Claude Code: access Spain's company registry, search by name, check NIF, trace history, find trademarks and risk signals.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: bormeapi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bormeapi/borme-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/borme-api

## What it does

BORME API is an MCP server hosted at `mcp.bormeapi.com`. It connects your AI assistant to Spain's commercial registry: company profiles, registration histories, trading names, and risk indicators. No local installation needed—you connect to the hosted server over HTTP.

Two authentication methods are available. Use an API key by passing it in the `X-API-Key` header with each request. Or use OAuth if you work in Claude.ai or ChatGPT: sign in once, and the app draws from your account's quota. Grab your API key from your account page at bormeapi.com.

Setup depends on your client. Claude Code takes a single terminal command. Cursor or VS Code need a JSON config with the server URL. Microsoft Copilot Studio walks you through the UI to create the connection. Claude.ai and ChatGPT use the built-in connector with OAuth signin. If an app goes unused for 30 days, reconnect it once before the next request.

## Requirements
- Remote server: `https://mcp.bormeapi.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http borme-mcp https://mcp.bormeapi.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add borme-api --url https://mcp.bormeapi.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "borme-api": {
            "url": "https://mcp.bormeapi.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "borme-api": {
            "type": "http",
            "url": "https://mcp.bormeapi.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http borme-api https://mcp.bormeapi.com/mcp
```

## When to use it
- look up a Spanish company by name or registration number
- retrieve the full registration history of a company
- find trademarks and trading names linked to a company
- surface risk signals from the official registry
- embed Spain's business registry into an agent on Claude or Copilot

## Example prompts
- Get the complete registration event history for the company with NIF 12345678Z
- List all companies registered with names containing 'TechCorp'
- Check for any risk flags associated with ABC Solutions SL

## Similar
- [BizVerify](https://affpapa.org/en/nevibecode/mcp/bizverify.md) — MCP server
- [BeeL](https://affpapa.org/en/nevibecode/mcp/beel.md) — MCP server · ★ 2 repo stars
- [mcp-registry-navigator](https://affpapa.org/en/nevibecode/agents/mcp-registry-navigator.md) — subagent · 628 installs
- [Boletín Claro](https://affpapa.org/en/nevibecode/mcp/boletin-claro.md) — MCP server
- [sumsub-conformance](https://affpapa.org/en/nevibecode/skills/sumsub-conformance.md) — skill · 1200 installs
- [sumsub-create-aml-resolution-rules](https://affpapa.org/en/nevibecode/skills/sumsub-create-aml-resolution-rules.md) — skill · 644 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
