api.rii.link/v1 · MCP · JSON

Build on the link layer.

One REST API for links, smart routing and analytics. An MCP server for AI agents. Every rii.link resolves for humans — and returns clean JSON for machines.

Explore the APISee the MCP server
Developer API

Drop link superpowers into your stack.

A fast, predictable REST API with SDKs and webhooks. Create, route, brand and measure links from anywhere in your software — in a few lines.

POST/v1/linksCreate a link
GET/v1/links/:idFetch a link
PATCH/v1/links/:idUpdate routing
POST/v1/qrGenerate a QR
GET/v1/analytics/:idClick & geo data
DEL/v1/links/:idRemove a link
create-link.js
// Generate a QR Code with logo
import { RiilinkClient } from '@riilink/sdk';

const client = new RiilinkClient('rii_live_...');

const qrCode = await client.qr.create({
  url: 'https://rii.link/summer-sale',
  style: {
    color: '#F97316',
    logo: 'https://myshop.com/logo.png',
    shape: 'rounded'
  }
});

console.log(qrCode.imageUrl);
Model Context ProtocolIn progress · Sept 2026

Let agents create, update & analyze links for you.

Connect rii.link as an MCP server and your AI assistant manages links the way it manages files — natural language in, real link operations out, analytics on demand.

✦
Assistant
connected to rii.link MCP
rii-mcp · 6 tools
Create a branded link for the summer sale that sends iPhone users to the App Store, and show me last week's clicks.
On it — creating the link with iOS routing, then pulling last week's clicks.
✦create_link✓ done
{ "slug": "summer-sale", "routing": { "ios": "apps.apple.com/id123" } }
✦get_analytics✓ done
{ "clicks_7d": 18423, "top_geo": "DE" }
Done — rii.link/summer-sale is live (iOS → App Store). Last week: 18,423 clicks, top geo DE.
⚡

Links from a sentence

"Shorten this and route DE traffic to /de" becomes a real, live link — no dashboard clicks.

↻

Update & route in place

Agents repoint destinations, add rules and rotate QR targets through typed tool calls.

▤

Analytics on demand

Ask for clicks, geos or top links and get structured results back into the conversation.

create_linkupdate_linkadd_routing_ruleget_analyticslist_linksgenerate_qr
No redirect required

Your link is now an endpoint.

Return raw JSON, HTML or XML straight from a short link. Built for app configs, deep linking, and agents that need structured data — not a 30x bounce.

01

Negotiated by header

Same link returns a redirect to browsers and clean JSON to Accept: application/json — perfect for LLM agents.

02

Edit without redeploying

Flip a feature flag or repoint a deep link from the dashboard. Your app reads it instantly.

03

Link AI — structured by default

Every link ships title, OG image, click count and routing as machine-readable metadata.

Read the API docs
~/rii — curl
$ GET rii.link/sale -H "Accept: application/json"
// rii returns structured data — no redirect
{
  "status": "active",
  "destination": "https://myshop.com",
  "routing": {
    "ios":     "apps.apple.com/app/id123",
    "android": "play.google.com/store/id123",
    "default": "myshop.com/web"
  },
  "meta": {
    "title": "Summer Sale 2026",
    "clicks": 18423,
    "llm_ready": true
  }
}
Works with your stack

Plug rii.link into everything.

Z
Zapier
#
Slack
GA
Analytics 4
∞
Meta Pixel
W
WordPress
◆
Webhooks
✦
Claude / MCP
M
Mailchimp
iOS SDK
▶
Android SDK
{ }
REST API
N
Node SDK

Ready to build smarter connections?

Branded links, visual routing and LLM-ready responses — start free, no credit card needed.

Start for freeRead the docs →
✓No credit card✓Free forever tier✓GDPR / DSGVO compliant✓Export & leave anytime