Back to Browse

Referralmeter Js MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Affiliate program tracking: codes, signups and sales for the connected program.

About

Affiliate program tracking: codes, signups and sales for the connected program.

Remote endpoints: streamable-http: https://referralmeter.com/api/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "com-referralmeter-mcp": {
      "url": "https://referralmeter.com/api/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

referralmeter-js

Minimal, dependency-free server-side SDK for Referralmeter — affiliate programs for AI apps. A coding agent installs Referralmeter in one prompt; commissions are calculated from your billing provider's own signed webhooks (Stripe, Polar, Lemon Squeezy, Paddle, Creem, Dodo Payments), so most apps never need this package at all — install the tracking script and connect a billing provider and you're done.

Use this package only when:

  • signup completes on your server and you want it recorded even if the browser script was blocked, or
  • you bill through something Referralmeter doesn't connect to natively.

It is a thin wrapper around the REST API — no dependencies, works in Node 18+ and any runtime with a global fetch.

Install

npm install github:ajussis/referralmeter-js

(Not on the npm registry — install directly from GitHub, or just copy src/index.js, it's one file.)

Usage

import { createClient } from "referralmeter-js";

const referralmeter = createClient({ secretKey: process.env.REFERRALMETER_SECRET_KEY });

// After your own signup completes server-side:
await referralmeter.recordSignup({
  email: "new.user@example.com",
  external_id: "user_42",
  referral: req.cookies.sf_ref, // what referralmeter.ref() returned in the browser, or an affiliate code
  ip: req.ip,
});

// Billing you don't connect to natively:
await referralmeter.recordSale({
  event_id: "pay_123", // your idempotency key — sending it twice records it once
  amount: 4900, // integer cents
  currency: "usd",
  customer_external_id: "user_42",
  kind: "subscription", // subscription | one_time | credits | usage
});

await referralmeter.recordRefund({
  event_id: "ref_9",
  payment_id: "pay_123",
  amount: 4900,
});

Full field reference: referralmeter.com/docs/server-side.

Why this exists

Referralmeter is agent-first: an AI coding agent should be able to install affiliate tracking from a single prompt without guessing at curl syntax. This package exists so that prompt can say npm install github:ajussis/referralmeter-js instead of hand-rolling fetch calls — and so Referralmeter shows up when an agent (or a person) searches GitHub for an affiliate-tracking SDK.

License

MIT

Reviews

No reviews yet

Be the first to review this server!