riveter-mcp-server

Riveter MCP Server

An MCP (Model Context Protocol) server that connects AI assistants like Claude and Cursor to the Riveter API. Run enrichments, build datasets, scrape webpages, manage monitors, and more — directly from your assistant.

Tools are generated dynamically from Riveter's OpenAPI spec, so they stay up to date automatically.

Setup

1. Get a Riveter API key

Go to app.riveterhq.com/settings/api and create an API key.

2. Configure your client

Claude Desktop — open the config file:

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

Add the Riveter server:

{
  "mcpServers": {
    "riveter": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "riveter-mcp-server@latest"],
      "env": {
        "RIVETER_API_KEY": "sk_riv_your_key_here"
      }
    }
  }
}

Cursor / Windsurf — add the same riveter entry to your MCP config (e.g. ~/.cursor/mcp.json).

Claude Code:

claude mcp add riveter --env RIVETER_API_KEY=sk_riv_your_key_here -- npx -y riveter-mcp-server

Codex:

codex mcp add riveter --env RIVETER_API_KEY=sk_riv_your_key_here -- npx -y riveter-mcp-server

Environment variables

Variable	Required	Default	Description
RIVETER_API_KEY	Yes	—	Your Riveter API key
RIVETER_API_BASE_URL	No	https://api.riveterhq.com/v1	API base URL
RIVETER_OPENAPI_URL	No	https://docs.riveterhq.com/openapi.yaml	OpenAPI spec URL

How it works

On startup, the server:

• Fetches the OpenAPI spec from docs.riveterhq.com/openapi.yaml
• Parses each endpoint into an MCP tool with typed parameters
• Serves the tools over stdio for your assistant to use

When the API docs are updated, the MCP server picks up the changes the next time your assistant launches — no rebuild or republish needed.

Support

Questions or issues? See the Riveter API docs or contact [e-mail].

License

MIT