@provenant/mcp

MCP server for Provenant — gives AI agents payment governance capabilities via the Model Context Protocol.

Install

npm install -g @provenant/mcp

Setup

Set environment variables:

export PROVENANT_URL=https://neighborly-clownfish-367.convex.cloud
export PROVENANT_API_KEY=prv_...
export PROVENANT_AGENT_ID=agent_...

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "provenant": {
      "command": "npx",
      "args": ["-y", "@provenant/mcp"],
      "env": {
        "PROVENANT_URL": "https://neighborly-clownfish-367.convex.cloud",
        "PROVENANT_API_KEY": "prv_...",
        "PROVENANT_AGENT_ID": "agent_..."
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "provenant": {
      "command": "npx",
      "args": ["-y", "@provenant/mcp"],
      "env": {
        "PROVENANT_URL": "https://neighborly-clownfish-367.convex.cloud",
        "PROVENANT_API_KEY": "prv_...",
        "PROVENANT_AGENT_ID": "agent_..."
      }
    }
  }
}

Project-level (.mcp.json)

{
  "mcpServers": {
    "provenant": {
      "command": "npx",
      "args": ["-y", "@provenant/mcp"],
      "env": {
        "PROVENANT_URL": "https://neighborly-clownfish-367.convex.cloud",
        "PROVENANT_API_KEY": "prv_...",
        "PROVENANT_AGENT_ID": "agent_..."
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | fetch | Make an HTTP request. On 402, auto-evaluates cost and pays if allowed. | | get_balance | Check agent's USDC wallet balance. | | list_agents | List all agents under your account. | | create_agent | Register a new AI agent. | | create_leash | Set spending rules (max-per-tx, daily/monthly velocity, approval threshold). | | list_transactions | View recent payment history. |

Development

npm run build
npm run dev    # watch mode
npm start      # run server

License

MIT