Firelinks

The Firelinks MCP Server lets external LLMs securely interact with the Firelinks API to manage short links, view statistics, handle custom domains, and discover available MCP endpoints. It centralizes access through a standards-based MCP interface, enabling your language models to perform common Firelinks actions without direct API calls.

How to use

You connect an MCP-enabled client to the server using the provided MCP endpoint. Once connected, you can perform actions such as creating and retrieving short links, listing all links, updating link URLs, and accessing detailed statistics. You can also manage domains and view the list of available services. Start by authenticating with your API token, then call the available tools through the MCP client to perform your desired operations.

How to install

Prerequisites you need before installing the MCP server:

• Node.js 20 or newer
• Docker and Docker Compose (for containerized runs)
• A Firelinks API token

Install locally

Clone the project directory, install dependencies, and run the server locally.

# Step 1: install dependencies
cd mcp-server
npm install

# Step 2: set up environment
cp .env.example .env

PORT=3000
LARAVEL_API_URL=https://firelinks.cc/api
NODE_ENV=development

# Step 3: start in standard mode
npm start

# Step 3 alternative: start in development mode with auto-reload
npm run dev

Run with Docker

If you prefer containerized runs, you can build and run the MCP server with Docker.

# Build the image
docker build -t firelinks-mcp-server .

# Run the container
docker run -d \
  -p 3000:3000 \
  -e LARAVEL_API_URL=https://firelinks.cc/api \
  --name firelinks-mcp-server \
  firelinks-mcp-server

Run with Docker Compose

You can start the MCP server alongside any required services using Docker Compose.

docker-compose up -d

Available tools

firelinks_create_link

Create a new short link with specified URL, type, and optional custom code or domain.

firelinks_get_link

Retrieve information for a specific short link by its code or ID.

firelinks_list_links

List all short links with optional filters.

firelinks_update_link_url

Update the destination URL of an existing short link.

firelinks_add_reserve_url

Add a reserve URL for a short link.

firelinks_stat_days

Fetch statistics broken down by day for a given date range.

firelinks_stat_total

Get total statistics for a specified period.

firelinks_stat_links

Get statistics for all links within a period.

firelinks_stat_clicks

Retrieve detailed click statistics for a link or set of links.

firelinks_stat_compare

Compare two periods to show performance differences.

firelinks_list_domains

List all registered custom domains.

firelinks_create_domain

Add a new custom domain.

firelinks_list_servers

List available MCP servers that can be queried.