mcp

The flexprice MCP server exposes the Flexprice API as MCP tools, enabling AI assistants and IDEs to manage customers, plans, prices, invoices, payments, events, and more through a standardized tool interface. After connecting, you can list available tools, inspect their input schemas, and execute operations directly from your editor or assistant. The server supports both a lightweight dynamic mode for on-demand discovery and a full tool surface for batch operations. Use the provided examples in your MCP client configuration to start interacting with resources like customers, invoices, events, and payments via simple tool invocations.

Prerequisites:

• Node.js v20 or higher
• npm or yarn
• Flexprice API key (from your Flexprice account)

Installation (Option A: npm package / one-liner):

1. Ensure Node.js is installed.
2. Run the server directly with npx:

npx @flexprice/mcp-server start --server-url https://us.api.flexprice.io/v1 --api-key-auth YOUR_API_KEY

Installation (Option B: local repo):

1. Clone the repository and navigate to the MCP server directory.
2. Install dependencies:

npm install

3. Create a .env file (based on .env.example) with:

BASE_URL=https://us.api.flexprice.io/v1
API_KEY_APIKEYAUTH=your_api_key_here

4. Build and start:

npm run build
npm start

Docker (stdio) example for running in a container:

docker build -t flexprice-mcp .
docker run -i -e API_KEY_APIKEYAUTH=your_api_key_here -e BASE_URL=https://us.api.flexprice.io/v1 flexprice-mcp node bin/mcp-server.js start

Tips and common scenarios:

• Ensure BASE_URL ends with /v1 and has no trailing slash or spaces; for npx, pass the server-url flag with the same value.
• If you encounter 404s on tool calls, verify that BASE_URL includes /v1 and the API key is valid.
• If you enable dynamic mode (--mode dynamic), the server will expose a lightweight set of meta-tools for discovery, helping reduce context size.
• When using Docker, pass API_KEY_APIKEYAUTH and BASE_URL as environment variables for the container.
• If you run into port conflicts, adjust the server startup settings or use a different host/port in your container or local run.