Elido

Create short links, generate QR codes and query click analytics in Elido (EU-hosted URL shortener) from any MCP client.

ドキュメント

@elido/mcp-server

Model Context Protocol server for Elido. Exposes link, QR, and analytics tools to any MCP-aware client (Claude Desktop, Cursor, Continue.dev, Claude Code, custom agents).

Status: beta (0.1.x). Expect additive changes; existing tool inputs will not break inside 0.1.x.

Install

Add the server to your client's MCP config. For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "elido": {
      "command": "npx",
      "args": ["-y", "@elido/mcp-server"],
      "env": {
        "ELIDO_API_KEY": "elido_…",
        "ELIDO_WORKSPACE_ID": "42"
      }
    }
  }
}

For Cursor, drop the same mcpServers block into .cursor/mcp.json inside your project. Restart the client and Elido tools appear in the agent's tool list.

Configuration

VariableRequired?Description
ELIDO_API_KEYyesAPI key (elido_…) from Settings → API Keys. Sent as Authorization: Bearer ….
ELIDO_WORKSPACE_IDoptionalNumeric workspace id. When omitted, the server picks the only workspace the key sees. Set this when the key has access to more than one.
ELIDO_API_BASEoptionalOverride the API host. Default https://api.elido.app. Useful for self-host.

Tools

ToolDescription
create_linkShorten a URL with optional slug, domain, title, and tags.
list_linksList recent links in the workspace (paginated).
query_analyticsClick-count timeseries for the workspace or a single link, TZ-bucketed.
generate_qrGenerate a QR code (SVG or PNG) for an existing link.
list_workspacesEnumerate workspaces this API key has access to.

query_analytics accepts tz (IANA name). Pass Europe/Berlin and the day buckets line up with the user's local clock instead of cluster-UTC.

Transport

stdio by default — the canonical MCP wire format. SSE transport is on the roadmap.

Build / develop

npm install
npm run build
npm test
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | ELIDO_API_KEY=test node dist/index.js

Source

Issues and PRs welcome at https://github.com/elidoapp/mcp-server. Releases are published to npm with provenance so the artifact is verifiable against the commit it was built from.

Links

License

MIT (c) Elido. The Elido service itself is a separate, hosted product; this repository contains only the client library.