# FINOS MCP - Common Domain Model (community)

> FINOS MCP - Common Domain Model (community) is an open-source MCP server for finance and payments. Inspect FINOS Common Domain Model types and validate trade JSON, with a read-only server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://vardhjain.github.io/finos-mcp/
- **Repository:** https://github.com/vardhjain/finos-mcp
- **MCP Registry name:** io.github.vardhjain/finos-mcp-cdm
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add finos-mcp-cdm -- uvx finos-mcp-cdm
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/finos-mcp-common-domain-model-community
