Skip to content
MCP server

FINOS MCP - Common Domain Model (community)

Inspect FINOS Common Domain Model types and validate trade JSON, with a read-only server

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.2
Listing updated
3 days ago

About FINOS MCP - Common Domain Model (community)

FINOS MCP - Common Domain Model (community) is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

CDM is the second of three sibling servers from one independent project, and it is the heaviest on data: the site cites 767 CDM types and 1,143 JSON schemas, with validation for trades in the Rune or legacy format. The registry entry names CDM version 7.8.0. A demo transcript on the project site shows the validator catching three planted defects in a Rune-format BusinessEvent.

A typical call is describe_type for TradeState, which returns the schema details of that type, which is useful when an assistant would otherwise guess at fields that do not exist. The standard is bundled with its upstream commit hash and a sha256 manifest verified at start-up, and the server makes no runtime network calls.

It installs from PyPI with uvx, needs Python 3.12 or newer and no API key, and runs over stdio on your machine. The author states it is community work, not an official FINOS product.

Install

Run in a terminal

claude mcp add finos-mcp-cdm -- uvx finos-mcp-cdm

Add to claude_desktop_config.json

{
  "mcpServers": {
    "finos-mcp-cdm": {
      "command": "uvx",
      "args": [
        "finos-mcp-cdm"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "finos-mcp-cdm": {
      "command": "uvx",
      "args": [
        "finos-mcp-cdm"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "finos-mcp-cdm": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "finos-mcp-cdm"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "finos-mcp-cdm": {
      "command": "uvx",
      "args": [
        "finos-mcp-cdm"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "finos-mcp-cdm": {
      "command": "uvx",
      "args": [
        "finos-mcp-cdm"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

describe_type
Returns schema details for a CDM type, for example TradeState.

What it does

CDM type lookup
Browse 767 Common Domain Model types.
Schema access
Retrieve the 1,143 JSON schemas for those types.
Trade validation
Check Rune and legacy format trade JSON for defects.
Verified bundle
Vendored standard checked by sha256 manifest at start.
No runtime network
Answers come from the bundled data only.
Read-only
Rate limits, size caps and an audit log back the read-only guarantee.

Good for

  • Look up the fields of a TradeState
  • Validate a BusinessEvent JSON before sending it on
  • Explain a CDM type to a developer
  • Stop an assistant inventing fields not in the schema

Pricing

Open source

Runs locally; no API key

Prices change. Check vardhjain.github.io before you buy.

FINOS MCP - Common Domain Model (community) FAQ

Which CDM version is covered?

The registry entry says CDM 7.8.0.

Does it need a model API or key?

No. The example recipes run locally with no paid model API or key.

How do I install it?

claude mcp add --scope user finos-cdm -- uvx --python 3.12 finos-mcp-cdm==0.3.2

Can it change trade data?

No. It is read-only.

What does describe_type return?

The schema details for the named type, such as TradeState.

Is FINOS MCP - Common Domain Model (community) free?

Yes. FINOS MCP - Common Domain Model (community) is open source, so you can use and self-host it for free.

How do I add FINOS MCP - Common Domain Model (community) to Claude Code?

Run this command in your terminal: claude mcp add finos-mcp-cdm -- uvx finos-mcp-cdm

What are the best alternatives to FINOS MCP - Common Domain Model (community)?

The closest alternatives to FINOS MCP - Common Domain Model (community) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to FINOS MCP - Common Domain Model (community)

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools