@bolagsapi/mcp-server

Official MCP (Model Context Protocol) server for BolagsAPI - Swedish company data for AI agents.

Enables Claude, ChatGPT, and other AI agents to access comprehensive Swedish company information including:

• Company lookup and search

• Financial analysis from annual reports

• Financial health and stability analysis

• Compliance screening (sanctions, PEP)

• Industry statistics and benchmarks

Installation

npm install -g @bolagsapi/mcp-server

Or use npx:

npx @bolagsapi/mcp-server

Related MCP server: nordic-registry-mcp-server

Requirements

• Node.js 18+

• BolagsAPI key (get one at bolagsapi.se/dashboard)

Quick Start

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "bolagsapi": {
      "command": "npx",
      "args": ["-y", "@bolagsapi/mcp-server"],
      "env": {
        "BOLAGSAPI_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "bolagsapi": {
      "command": "npx",
      "args": ["-y", "@bolagsapi/mcp-server"],
      "env": {
        "BOLAGSAPI_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

VS Code with Continue

Add to your Continue configuration:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@bolagsapi/mcp-server"],
          "env": {
            "BOLAGSAPI_KEY": "sk_live_your_api_key_here"
          }
        }
      }
    ]
  }
}

Available Tools

Company Intelligence

Financial & Health

Compliance & Reference

Environment Variables

HTTP Transport (Remote)

For remote deployments, use the HTTP transport:

# Start HTTP server
npm run start:http

# Or with Docker
docker build -t bolagsapi-mcp .
docker run -p 3001:3001 -e BOLAGSAPI_KEY=sk_live_xxx bolagsapi-mcp

Environment variables for HTTP mode:

• PORT: HTTP port (default: 3001)

• HOST: Bind address (default: 127.0.0.1)

HTTP Authentication

The HTTP transport requires Bearer token authentication:

curl -X POST http://localhost:3001/mcp \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Example Usage

Once configured, you can ask Claude:

"Look up information about Spotify (org nr 556703-7485)"

"Search for AI companies in Stockholm"

"Analyze the financials for IKEA"

"Check if company 5566778899 has any sanctions hits"

"What's the financial health of org 556677-8899?"

Development

# Clone the repo
git clone https://github.com/HugoAndFriends/BolagsAPI-mcp-server.git
cd BolagsAPI-mcp-server

# Install dependencies
pnpm install

# Run in development mode
BOLAGSAPI_KEY=sk_live_xxx pnpm dev

# Build
pnpm build

Security

• API keys are validated against the BolagsAPI backend

• Rate limiting: 100 requests/minute per IP (HTTP mode)

• DNS rebinding protection for localhost bindings

• CORS enabled for browser clients

Support

• Documentation: bolagsapi.se/docs

• Issues: github.com/HugoAndFriends/BolagsAPI-mcp-server/issues

• Email: dev@bolagsapi.se

License

MIT