MCP

MCP documentation

Connect AI assistants and autonomous agents to corween. The MCP server runs inside our application and exposes supplier monitoring as structured tools.

What is MCP?

corween implements a Model Context Protocol (MCP) server so AI assistants can interact with supplier monitoring without scraping public registers.

Instead of giving your AI raw REST endpoints, MCP exposes high-level tools the model can call directly:

  • Register a new organisation and obtain an API token
  • Add, update and remove monitored suppliers (subjects)
  • List subjects and inspect their current risk events
  • Query monitoring events across your portfolio with filters

How it works

The MCP server is part of the corween Spring Boot application — not a separate Node.js service. AI clients connect to the same deployment over HTTP.

MCP tools call the same internal services as our REST API. When we change business logic, the build fails if MCP tools are out of sync.

Data flow
AI client (Cursor, Claude Desktop, …)
  → MCP over HTTP (/mcp)
  → CorweenMcpTools (@McpTool)
  → SubjectService / RegistrationService / SubjectEventService
  → PostgreSQL + register fetchers

For direct system integration without an AI layer, use our REST API documentation instead.

Connection

Use Streamable HTTP transport. Point your MCP client to the /mcp endpoint on your {0} instance.

Endpoint
/mcp
Protocol
Streamable HTTP

Cursor example

Add this to your Cursor MCP settings (project or global):

Cursor MCP
{
  "mcpServers": {
    "corween": {
      "url": "https://corween.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Authentication

Registration tools are public. All subject and event tools require the same API token used for REST API access. Send it in the MCP HTTP Authorization header — your client forwards it on every tool call.

Header
Authorization: Bearer {api_token}

Obtain a token via corween_register or from your account administrator. The token is tied to your organisation account.

Available tools

Each tool maps to internal business operations. Parameters are validated the same way as REST API requests.

Supported countries for subjects: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.

TOOL corween_register

Register account

Creates a new account and user, sends email verification and returns an API token for immediate use.

No authentication required.

TOOL corween_confirm_registration

Confirm registration

Activates the account using the verification token from the registration email.

No authentication required.

TOOL corween_list_subjects

List subjects

Returns monitored suppliers for the authenticated account. Optional filters: name, registrationNumber, taxIdentifier, birthDate, type, country, page, resultsPerPage.

Optional parameters

Name Type Description
name string Filter by subject name (partial match).
registrationNumber string Filter by company ID / registration number (partial match).
taxIdentifier string Filter by tax identifier (partial match).
birthDate string Filter by date of birth. Format: YYYY-MM-DD.
type enum Filter by subject type. Allowed values: COMPANY, PERSON.
country enum Country code. Allowed values: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Zero-based page index.
resultsPerPage number Maximum number of items per page.
TOOL corween_get_subject

Get subject

Returns subject details including note and related monitoring events.

TOOL corween_add_subject

Add subject

Adds a company to monitoring. Country + registration number must be unique within the account.

TOOL corween_update_subject

Update subject

Updates the note on a monitored subject. Country, name and registration number cannot be changed.

TOOL corween_remove_subject

Remove subject

Removes a subject and deletes related monitoring data.

TOOL corween_list_events

List events

Returns monitoring events — detected register changes (insolvency, ownership, financial signals, etc.) for your subjects.

Optional parameters

Name Type Description
subjectId number Filter by numeric subject identifier.
country enum Country code. Allowed values: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Zero-based page index.
resultsPerPage number Maximum number of items per page.

Typical agent workflow

  1. Connect your AI client to /mcp with a valid API token (or call corween_register first).
  2. Confirm the account via email (corween_confirm_registration or the confirmation link).
  3. Add suppliers with corween_add_subject (country, name, registration number).
  4. Poll corween_list_events or corween_get_subject to check for new risks.
  5. Let the agent summarise findings, draft alerts or update notes via corween_update_subject.