LinkJolt

npx add-mcp 'https://www.linkjolt.io/api/mcp'

MCP Server

Connect LinkJolt to Claude, ChatGPT, and other AI assistants. Manage your affiliate program with natural language.

What is MCP?

The Model Context Protocol (MCP) lets AI assistants like Claude interact with external tools. The LinkJolt MCP server gives your AI assistant direct access to your affiliate program data, so you can ask things like "Show me my top affiliates this month" or "Create a conversion for order #123".

Hosted server (no install)

The fastest way in: point your MCP client at LinkJolt's hosted endpoint. Connector apps like claude.ai sign in with OAuth; developer tools can pass an API key header instead. Nothing to install, always up to date.

Connect your AI assistant

These two apps sign in with OAuth on a LinkJolt page, so there is no API key to create, copy or store.

Claude

ChatGPT

Add LinkJolt to Claude

LinkJolt is listed in Claude's connector directory. Add it there, then approve access on the LinkJolt page that opens. It shows up in Claude Desktop too, since connectors follow your Claude account.

Or add it as a custom connector

Same connector, same sign-in. Open the prefilled custom connector form, or follow these steps.

1

Open Customize, then Connectors, then Add custom connector

In claude.ai or Claude Desktop.

2

Enter the name and server URL

Name: LinkJolt. URL: https://www.linkjolt.io/api/mcp. Keep the authentication settings Claude detects; Claude's published identity is the recommended OAuth client, and LinkJolt supports Client ID Metadata Documents and automatic registration, so there is no client ID or secret to paste.

3

Approve access when Claude first needs your account

Planning questions work straight away. The first time Claude needs your account, it opens a LinkJolt page: sign in (or create an account), then click Approve. The page lists exactly what Claude can read and write, access is scoped to your active brand, and the connector never sends money.

Using Claude Code, Cursor, VS Code or Codex instead? Those connect from the terminal, not this screen. See the developer tool setup.

Endpoint

https://www.linkjolt.io/api/mcp

Streamable HTTP transport, speaking MCP revisions 2024-11-05 through 2025-06-18 (initialize handshake) and the stateless 2026-07-28 revision (per-request metadata and server/discover). OAuth-capable clients discover the sign-in flow automatically. Clients that support custom headers can instead send your API key in an Authorization: Bearer lj_pk_your_key header (X-Api-Key also works). Create keys in the dashboard under API Keys.

Add it to your client

Claude Code:

claude mcp add --transport http linkjolt \
  https://www.linkjolt.io/api/mcp \
  --header "Authorization: Bearer lj_pk_your_key"

Cursor, VS Code, Windsurf and other clients with remote server support:

{
  "mcpServers": {
    "linkjolt": {
      "url": "https://www.linkjolt.io/api/mcp",
      "headers": {
        "Authorization": "Bearer lj_pk_your_key"
      }
    }
  }
}

Which method to use: claude.ai, Claude Desktop, and ChatGPT connect with OAuth (one-click connector above, no key handling; ChatGPT cannot send an API key at all). Claude Code and Codex can sign in with OAuth too (run /mcp in Claude Code, or codex mcp login linkjolt), or send the API key header like Cursor, VS Code, Windsurf and the Claude API MCP connector. Clients that only speak stdio can use the npm package below. OAuth access follows your plan the same way keys do: reading, setting up and running the program on Professional and above, the three writes on sales on Ultimate and Scale.

Local install (npm package)

Only for clients that can run a local command but cannot reach a remote server. The package is a small relay: it passes every request to the hosted endpoint with your API key, so it has exactly the same tools and prompts. Cursor, VS Code, Windsurf, Claude and ChatGPT all connect to the hosted endpoint directly and sign in through the browser, with no key to paste, so prefer that wherever you can.

Install the package

npm install -g @linkjolt/mcp-server

Configure your AI client

Add to your Claude Desktop config:

{
  "mcpServers": {
    "linkjolt": {
      "command": "npx",
      "args": ["-y", "@linkjolt/mcp-server"],
      "env": {
        "LINKJOLT_API_KEY": "lj_pk_your_key"
      }
    }
  }
}

Available Tools

plan_affiliate_program

Suggest a commission and program structure from published benchmarks, with what an affiliate earns per sale

get_linkjolt_plans

Plans, prices, tracked-sales limits and how the free trial works (not offered in ChatGPT, whose plugin rules leave plans out)

switch_from_another_tool

Move a program from Rewardful, Tolt, FirstPromoter, Affonso or a CSV: the page to paste the old key on, and what happens next

get_setup_status

Where setup stands: business details, launch steps, tracking script and join links

update_business

Set the business name and website

create_campaign

Create a campaign and get its join link for affiliates

get_tracking_instructions

Tracking steps for one payment platform, filled in with your script and webhook address

check_tracking

Check the install works: your tag on the page, the script running, payments connected, a test purchase arrived

invite_affiliate

Email one person an invitation to join a campaign

update_affiliate_status

Approve or reject an affiliate waiting for review on a campaign

list_campaigns

List all your affiliate campaigns with stats

get_campaign

Get detailed campaign info including affiliate count

list_affiliates

List affiliates across your campaigns

list_conversions

List conversions with filters (status, date, campaign)

get_stats

Get aggregate stats (revenue, commissions, conversions)

create_conversion

Manually create a conversion record

update_conversion

Update conversion status (approve/reject)

list_teams

List Affiliate Teams with rosters, targets, and pending awards

get_team

Get one team with members, campaigns, and goals

list_team_goals

List a team's targets and current-period progress

list_awards

List bonus awards across all teams for reconciliation

list_coupons

List registered affiliate coupon codes

list_payouts

List the affiliate payout queue for reconciliation

search

Search campaigns, affiliates, conversions and coupons by text (ChatGPT compatible)

get_program_overview

Month revenue, top affiliates and recent conversions; renders as an interactive card in Claude

fetch

Fetch one record by a search result id (ChatGPT compatible)

Interactive widget (MCP Apps)

Ask for your program overview in Claude (web or desktop) and the answer renders as an interactive card: month revenue, a top-affiliates leaderboard, and recent conversions. Clients without MCP Apps support get the same data as plain JSON from the get_program_overview tool.

Prompts

The server also ships ready-made workflows as MCP prompts. Clients surface them as one-click actions; Claude Code renders each as a slash command like /mcp__linkjolt__weekly_performance_review.

weekly_performance_review

Revenue, conversions, top affiliates, and one suggested action for next week

reconcile_pending_conversions

Triage pending conversions with recommendations; never approves on its own

draft_affiliate_update

Draft a monthly update email to affiliates grounded in real numbers

Setup and running the program from the chat, plus three deliberate writes on sales

The two planning tools answer before anyone signs in. Every other tool works on the signed-in account, and Claude asks the person to connect their LinkJolt account (or create one) the first time it calls one. On Pro and above the connector can set a program up: name the business, create a campaign, give the tracking steps, and email invitations (invite_affiliate sends a real email, so the assistant confirms the address first). Once it runs, the connector changes a campaign's terms (update_campaign) and approves or rejects affiliates waiting for review (update_affiliate_status), each confirmed with you first. Connecting Stripe or another payment platform stays in the browser. The planning and setup tools are on the hosted connector at https://www.linkjolt.io/api/mcp; the npm package carries the rest.

Three writes touch sales (create_conversion, update_conversion, create_coupon), all Ultimate or Scale only. Bonus award approval is deliberately not exposed as a tool: approving a team bonus award moves money, and an AI assistant should not approve payouts autonomously. Approve awards from the dashboard, or with a deliberate REST API call. Team, coupon, and payout tools respect your API key\'s plan and permissions, so a Pro key or a non-Scale plan gets the same errors the REST API returns.

Example Conversation

U

You

Show me my top performing campaign this month

AI

Claude

I'll check your campaigns. Your "Pro Campaign" is performing best with $12,350 in revenue from 47 conversions. It has 12 active affiliates earning a 20% commission rate.

U

You

Which affiliates are driving the most revenue?

AI

Claude

Looking at your affiliates... Sarah from TechReviews generated $4,200 (34%), followed by Alex from SaaSDigest at $3,100 (25%). Both are in Tier 2 of your commission structure.

Connect to the hosted endpoint at https://www.linkjolt.io/api/mcp and sign in through the browser. Clients that only run local commands can use npx -y @linkjolt/mcp-server with an API key, as above.

New to LinkJolt?

Start a 7-day free trial, create your first campaign, then connect your AI assistant. The MCP server is included on the Professional plan and above.