MCP 服务器

Trust OS MCP Server

MCP server for verifying high-impact decisions with Trust OS.

README

Trust OS MCP Server

MCP server for verifying high-impact decisions with Trust OS.

Connect any MCP-compatible AI agent — Claude Desktop, Cursor, or any MCP client — to the Trust OS Decision Verification API and verify financial and operational decisions before execution.

Links

Website: https://trust-os.io
Docs: https://trust-os.io/docs
API Reference: https://trust-os.io/docs/api
Playground: https://demo.trust-os.io
Operations Demo: https://ops.trust-os.io
OpenAPI: https://trust-os.io/openapi.json
GitHub Org: https://github.com/trustos-trustfolio

What it does

The Trust OS MCP Server exposes the Trust OS Decision Verification API as an MCP tool. When an AI agent calls verify_decision, the server:

Validates the input (action, amount, currency, destination, etc.)
POSTs the payload to Trust OS /v1/decision/verify
Returns a structured response including risk score, recommendation, and cryptographic proof

Installation

git clone https://github.com/trustos-trustfolio/trustos-mcp-server.git
cd trustos-mcp-server
npm install
npm run build

Environment Variables

Copy .env.example to .env and fill in your API key:

cp .env.example .env

Variable	Required	Description
`TRUSTOS_API_KEY`	Yes	Your Trust OS API key
`TRUSTOS_BASE_URL`	No	Override API base URL (default: Trust OS gateway)

Never commit .env to version control.

Claude Desktop Configuration

Add the following to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "trustos": {
      "command": "node",
      "args": ["C:/trustos-mcp-server/dist/index.js"],
      "env": {
        "TRUSTOS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

See examples/claude_desktop_config.json for the full example.

Claude Desktop config file location:

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

Tool: `verify_decision`

Description: Verify a high-impact decision before execution using Trust OS.

Input schema:

Field	Type	Required	Description
`action`	string	Yes	The action or decision to verify
`amount`	number	No	Monetary amount involved
`currency`	string	No	Currency code (e.g. USDC, USD)
`destination`	string	No	Destination address or identifier
`source`	string	No	Source address or identifier
`priority`	string	No	Priority level (e.g. high, critical)
`metadata`	object	No	Additional context as key-value pairs

Example Prompt

Use Trust OS to verify this decision before execution:
action stablecoin_transfer, amount 50000, currency USDC, destination wallet_abc.

Example Response

Trust OS Decision Verification Result
════════════════════════════════════════
decision_id   : txn_a1b2c3d4
recommendation: APPROVE
risk_score    : 12
risk_level    : LOW
policy        : standard_transfer_policy
proof_hash    : 0xabc123...
verified      : true
latency_ms    : 142

Full response:
{
  "decision_id": "txn_a1b2c3d4",
  "recommendation": "APPROVE",
  "risk_score": 12,
  ...
}