Intuition MCP Monorepo

Model Context Protocol servers for the Intuition knowledge graph and trust network. Ships two MCP servers and an interactive playground for exploring them.

Playground: mcp.intuition.box

Monorepo Structure

├── packages/
│   ├── mcp-general/       # @intuition-box/mcp-general — Intuition knowledge graph MCP
│   │                        8 tools: accounts, followers, relations, atoms, lists
│   └── mcp-trust/         # @intuition-box/mcp-trust — Trust scoring MCP
│                            7 tools: EigenTrust, AgentRank, sybil detection, composite scores
├── apps/
│   └── playground/        # Next.js app — MCP directory, per-server playgrounds, docs
└── package.json           # npm workspaces root

Getting Started

Prerequisites

• Node.js >= 18
• npm >= 9 (ships with Node 18+)

Quick Start

git clone https://github.com/intuition-box/mcp.git
cd mcp
npm install
npm run dev

npm run dev starts the playground at http://localhost:3000.

Note: An .npmrc with legacy-peer-deps=true is checked in so npm install works without extra flags.

Running Individual Packages

# Intuition MCP server (watch mode)
npm run dev --workspace packages/mcp-general

# Trust Score MCP server
npm run dev --workspace packages/mcp-trust

Building

# Build all workspaces
npm run build

# Build a single package
npm run build --workspace packages/mcp-general
npm run build --workspace packages/mcp-trust

Testing

# Run all workspace tests
npm test

# Run tests for a specific package
npm test --workspace packages/mcp-trust

Claude Desktop Integration

Add both servers to your Claude Desktop config to give Claude access to the full Intuition toolkit.

Config file location:

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

{
  "mcpServers": {
    "intuition": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/packages/mcp-general/dist/index.js"],
      "env": {
        "NEXT_PUBLIC_INTUITION_GRAPH_URL": "https://graph.intuition.systems/graphql"
      }
    },
    "trust-score": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/packages/mcp-trust/dist/index.js"],
      "env": {
        "NEXT_PUBLIC_INTUITION_GRAPH_URL": "https://graph.intuition.systems/graphql"
      }
    }
  }
}

Replace /absolute/path/to/mcp with the path where you cloned the repo. Restart Claude Desktop after saving.

Packages

@intuition-box/mcp-general

MCP server for the Intuition knowledge graph. Provides read access to accounts, relationships, atoms, and curated lists.

@intuition-box/mcp-trust

Trust computation engine over the Intuition attestation graph. Implements EigenTrust, AgentRank, sybil detection, and path-based trust.

License

MIT