@provenedge/realize-mcp

MCP server for the ProvenEdge Realization Engine. Connects AI agents (Claude Code, Cursor, Windsurf, etc.) to your entities, records, views, relationships, and documents via the Model Context Protocol.

Quick Start

No install needed — just configure your AI client:

Claude Code (.mcp.json in project root or ~/.claude/.mcp.json globally):

{
  "mcpServers": {
    "provenedge": {
      "command": "npx",
      "args": ["-y", "@provenedge/realize-mcp"],
      "env": {
        "SCAFFOLD_API_URL": "https://api.provenedge.com",
        "SCAFFOLD_API_KEY": "pe_live_..."
      }
    }
  }
}

Then restart your AI agent to pick up the new server.

Getting an API Key

1. Log in to your ProvenEdge workspace
2. Go to Settings > API Keys
3. Create a key with READ or READ_WRITE scope
4. Copy the key (it's only shown once)

Environment Variables

| Variable | Required | Description | |---|---|---| | SCAFFOLD_API_KEY | Yes | Your API key (pe_live_...) | | SCAFFOLD_API_URL | No | API base URL (defaults to http://localhost:4000) |

Available Tools

27 tools across these categories:

| Category | Tools | Scope | |---|---|---| | Entities | list, get, create, update, delete, stats | READ / READ_WRITE | | Fields | list, add, update, delete | READ / READ_WRITE | | Records | list, get, create, update, delete, search | READ / READ_WRITE | | Views | list, get, create, execute, delete | READ / READ_WRITE | | Relationships | list, create, get_related, link, unlink | READ / READ_WRITE | | Notes | list, add | READ / READ_WRITE | | Import | csv | READ_WRITE | | Audit | get_audit_log | READ | | Profile | get_profile, get_storage_usage | READ | | Documents | list_documents | READ |

Supported Clients

| Client | Config Location | |---|---| | Claude Code | .mcp.json in project root or ~/.claude/.mcp.json | | Cursor | Settings > MCP Servers or ~/.cursor/mcp.json | | Windsurf | Settings > MCP | | Continue | ~/.continue/config.json under mcpServers | | Cline | Settings > MCP Servers |

Pin a Version

"args": ["-y", "@provenedge/[email protected]"]

Security

• API keys authenticate as USER role (never elevated, even if the user has ADMIN/SUPERADMIN)
• READ keys can only read data; READ_WRITE keys can modify data
• Keys can be revoked instantly from the web UI
• Rate limited: 100 requests/minute per key

License

MIT