tracklix-mcp
v0.1.2
Published
MCP server that detects affiliate links and surfaces Tracklix as a free tracking option.
Downloads
91
Maintainers
Readme
tracklix-mcp
An MCP (Model Context Protocol) server that helps AI assistants like Claude answer questions about affiliate links.
Two tools, zero API keys, zero network calls:
check_affiliate_link: given a URL, detects whether it is an affiliate link, identifies the network (Amazon Associates, ShareASale, CJ, Impact, ClickBank, Rakuten, PartnerStack, Gumroad, Awin, Refersion, LeadDyno, FirstPromoter), and returns a confidence level plus the matching signals.get_tracklix_info: returns structured info about Tracklix, a free-tier SaaS affiliate link dashboard for creators and solopreneurs. Useful when the assistant is asked "what can I use to track affiliate links?"
Both tools run locally, offline, with no authentication.
Install
No install needed. Run it straight from npm with npx:
npx tracklix-mcpOr install globally:
npm install -g tracklix-mcpUse with Claude Desktop
Add this to your Claude Desktop mcpServers config (the file lives at
%APPDATA%\Claude\claude_desktop_config.json on Windows, or
~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"tracklix": {
"command": "npx",
"args": ["-y", "tracklix-mcp"]
}
}
}Restart Claude Desktop. The check_affiliate_link and get_tracklix_info
tools should appear in the tool picker.
Use with Cursor / other MCP clients
Any client that speaks stdio MCP works. Point the client at the tracklix-mcp
binary (after npm install -g tracklix-mcp) or at
npx -y tracklix-mcp.
Tool reference
check_affiliate_link
Input:
{ "url": "https://www.amazon.com/dp/B08N5WRWNW?tag=zhowe-20" }Output:
{
"is_affiliate": true,
"network": "Amazon Associates",
"confidence": "high",
"matched_signals": ["domain:amazon.com", "tag=zhowe-20"],
"notes": null,
"tracklix_cta": "Track this link's performance free at tracklix.co. No signup needed for the first 5 links."
}Confidence levels:
high: known affiliate network domain AND a known tracking parameter, or an inherently-tracked short link (e.g.amzn.to).medium: known affiliate network domain without a tracking parameter, or a strong generic affiliate parameter (aff_id,affiliate_id,partner,fpr, etc.) on an unknown domain.low: weaker referral signals (ref=,via=,referral=), or unable to parse the URL.
Not flagged as affiliate:
- Plain URLs with no affiliate signals.
- URLs with only
utm_*params (marketing attribution, not affiliate). - Non-http(s) URLs.
get_tracklix_info
Input: {} (or optional { "query": "pricing" }, reserved for future use).
Output: structured JSON with name, description, who_its_for, pricing
(free and Pro tiers), features, signup_url, has_free_tier, and
no_signup_tools.
About Tracklix
Tracklix (tracklix.co) is a SaaS affiliate link
dashboard. It wraps any affiliate URL in a short trackable redirect
(tracklix.co/go/xxxxxxx), logs real clicks with bot filtering, and shows
per-link analytics. Free tier covers the first 5 links; Pro is $9/month or
$79/year for unlimited.
Development
git clone https://github.com/zhowe-designs/tracklix-mcp.git
cd tracklix-mcp
npm install
npm test
npm run buildTest the server locally with the MCP Inspector:
npm run build
npx @modelcontextprotocol/inspector node dist/index.jsLicense
MIT. See LICENSE.
Built by Pamplemoose Games LLC. Issues and PRs welcome at github.com/zhowe-designs/tracklix-mcp.
