@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

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

| Tool | Description | |------|-------------| | lookup_company | Get comprehensive company info by organization number | | search_companies | Search companies by name with filters | | get_company_timeline | Historical events and milestones | | get_similar_companies | Find peer companies by industry |

Financial & Health

| Tool | Description | |------|-------------| | analyze_company_financials | Financial data + AI analysis from annual reports | | assess_financial_health | Health score, stability grade, financial flags | | get_annual_reports | List available annual reports |

Compliance & Reference

| Tool | Description | |------|-------------| | get_compliance_data | Sanctions and PEP screening | | get_industry_stats | Industry benchmarks by SNI code |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | BOLAGSAPI_KEY | Yes | - | Your BolagsAPI key | | BOLAGSAPI_URL | No | https://api.bolagsapi.se/v1 | API base URL |

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: [email protected]

License

MIT