Senserity MCP Server

MCP (Model Context Protocol) server for the Senserity risk intelligence platform. Enables AI agents to perform UK company due diligence through natural language.

Quick Start

1. Get an API key

Create an API key in your Senserity dashboard at Settings > API. Requires a Professional or Enterprise subscription.

2. Add to your AI tool

Claude Desktop / Claude Code

Add to your MCP configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "senserity": {
      "command": "npx",
      "args": ["senserity-mcp-server"],
      "env": {
        "SENSERITY_API_KEY": "sns_live_your_key_here"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

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

{
  "mcpServers": {
    "senserity": {
      "command": "npx",
      "args": ["senserity-mcp-server"],
      "env": {
        "SENSERITY_API_KEY": "sns_live_your_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json or your VS Code settings:

{
  "servers": {
    "senserity": {
      "type": "stdio",
      "command": "npx",
      "args": ["senserity-mcp-server"],
      "env": {
        "SENSERITY_API_KEY": "sns_live_your_key_here"
      }
    }
  }
}

Windsurf

Add via Settings > MCP Servers > Add Server, using the same mcpServers format as Claude Desktop above.

3. Restart your AI tool

After saving the configuration, restart the application. The Senserity tools will appear in the tool list.

Available Tools

| Tool | Description | |------|-------------| | senserity_search_companies | Search the watchlist by name or company number | | senserity_get_company | Get full company profile including registered address, SIC codes, and status | | senserity_get_risk_summary | Overall risk score, letter grade, category breakdown, red flags, and trajectory | | senserity_list_insights | All insight test results grouped by risk category | | senserity_run_insights | Trigger a fresh risk assessment (consumes credits) | | senserity_poll_run | Check status of a running assessment | | senserity_list_reports | List existing PDF due diligence reports | | senserity_generate_report | Generate a new PDF report (consumes 2 credits) | | senserity_get_alerts | Get risk alerts, filterable by company and severity | | senserity_add_to_watchlist | Add a company to the monitoring watchlist | | senserity_toggle_monitoring | Enable/disable monitoring, update frequency or label |

Example Conversations

"What's the risk profile of Tesco PLC?"

The agent searches for Tesco, then calls senserity_get_risk_summary to return the overall score, grade, red flags, and executive summary.

"Add Rolls-Royce to our watchlist and run a full assessment"

The agent calls senserity_add_to_watchlist, then senserity_run_insights, then polls with senserity_poll_run until complete.

"Show me any high-severity alerts from the last week"

The agent calls senserity_get_alerts with severity and date filters.

Requirements

• Node.js 18 or later
• A Senserity Professional or Enterprise subscription with API access enabled
• A valid API key (create one at Settings > API in your dashboard)

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SENSERITY_API_KEY | Yes | — | Your API key (sns_live_...) | | SENSERITY_API_URL | No | https://app.senserity.co.uk | Senserity instance URL |

How It Works

The MCP server is a thin wrapper over the Senserity REST API. It authenticates using your API key and makes HTTP requests to the same endpoints available to any API consumer. No direct database access.

AI Agent → MCP Protocol → senserity-mcp-server → Senserity REST API

Links

• Senserity — risk intelligence for UK companies
• MCP Integration Guide — full setup documentation
• API Reference — OpenAPI specification
• Model Context Protocol — MCP specification

License

Proprietary. Copyright Blueloop Limited.