firelinks_add_reserve_url
Add a reserve URL to an existing link. The reserve URL will be used if the main URL is unavailable.
LABSCO SUMMARY
Reporting is the deeper half of this, not link creation.
Five of the thirteen tools are statistics, including a period-over-period comparison — that is the part you cannot do by pasting a URL into a web form. Setup is one npx line with the token in your client configuration.
What it is
A Node server in front of the Firelinks link-shortening platform, run on your own machine. It covers link creation and editing, several shapes of click reporting, custom domains, and the list of available servers.
What you get
- Short links created with a custom code, a chosen redirect type — 301, 302, 303 or META Refresh — and optional keywords and grouping —
firelinks_create_link - Links read individually or listed, with the destination URL updated in place and reserve URLs added —
firelinks_get_link,firelinks_list_links,firelinks_update_link_url,firelinks_add_reserve_url - Click statistics by day, totals over a period, per-link breakdowns, detailed click records, and a two-period comparison —
firelinks_stat_days,firelinks_stat_total,firelinks_stat_links,firelinks_stat_clicks,firelinks_stat_compare - Custom domains listed and added —
firelinks_list_domains,firelinks_create_domain - The available servers listed —
firelinks_list_servers
Requirements
A Firelinks account and its API token, set as FIRELINKS_API_TOKEN in the client configuration, and Node.js 20.0.0 or higher. The repository also has a Docker image and an HTTP mode with a /health check for running it as a service. The README names a hosted endpoint at mcp.firelinks.cc, but in September 2026 that address served an unrelated web page, not MCP.
Setup effort
One command plus a key — npx -y github:djeknet/firelinks-mcp, then supply credentials
USE CASES
01
Shipping a campaign link with a readable slug
Create the link on your own domain with a custom code and the redirect type the campaign needs, then confirm it reads back correctly.
02
Reporting on how a campaign performed
Pull daily numbers over the campaign window, then compare that period against the previous one instead of eyeballing two charts.
03
Repointing a link whose destination moved
Update the destination URL in place so everything already published keeps working, and add a reserve URL as a fallback.
04
Auditing what is live across your domains
List the domains and then the links on them, with per-link click totals, to find what is still driving traffic and what is dead weight.
13 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
firelinks_create_domain
Add a new domain to the system. The domain must be configured to point to the specified server. The system will verify the correctness of DNS settings.
firelinks_create_link
Create a new short link in the Firelinks system. Allows shortening a long URL and getting a short link with additional parameters.
firelinks_get_link
Get information about a specific link by its ID.
firelinks_list_domains
Get a list of all user domains with filtering capabilities. Domains are used to create branded short links.
firelinks_list_links
Get a list of all user links with filtering and pagination capabilities. Supports filtering by code, date range, URL, clicks, title, link name, and status.
firelinks_list_servers
Get a list of all available servers in the Firelinks system. Servers are used to host domains and handle redirects.
firelinks_stat_clicks
Get detailed click statistics with extensive filtering options: time range, links, IP, geo, device, browser, OS, referer, traffic quality, and more.
firelinks_stat_compare
Compare statistics between two periods grouped by various parameters. Useful for analyzing traffic changes by link, location, device, browser, and more.
firelinks_stat_days
Get click statistics by day for the specified period. Returns the number of clicks for each day.
firelinks_stat_links
Get statistics for user links for the period. Shows the number of clicks for each link. Can filter by specific link ID or array of link IDs.
firelinks_stat_total
Get total aggregate statistics for the period. Includes total clicks, unique visitors, and other metrics.
firelinks_update_link_url
Update the target URL of an existing short link.
BEFORE YOU INSTALL
What to know first
Tools you get
13 tools when we connected.
Requires
- npx on PATH
- Node.js >= 20.0.0
- FIRELINKS_API_TOKEN in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 13 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"firelinks-mcp": {
"command": "npx",
"args": [
"-y",
"github:djeknet/firelinks-mcp"
],
"env": {
"FIRELINKS_API_TOKEN": "<YOUR_FIRELINKS_API_TOKEN>"
}
}
}
}npx
TERMINAL
npx -y github:djeknet/firelinks-mcp
