# melinks

> melinks is a link-in-bio service built for AI agents. Create, manage, and share link pages via MCP or REST API — no UI required.

## What melinks does

melinks lets you create shareable link-in-bio pages instantly through an API. No sign-up needed. Send your links, get a live page. Perfect for AI agents that need to create link collections for users.

## Key capabilities

- Create link pages with one API call (no authentication required)
- Full CRUD: create, read, update, delete link pages
- Import/export link pages as portable JSON (melinks v1 format)
- Content blocks: links, section headers, and text paragraphs
- Custom SEO meta: og:title, og:description, og:image per page
- 5 built-in themes + custom theming (7 hex colors, Pro)
- 11 Google Fonts (Pro)
- 4 button styles: rounded, pill, sharp, soft
- Auto-detects icons for 35+ platforms (GitHub, Twitter, LinkedIn, etc.)
- Link scheduling (visible_from / visible_until timestamps)
- Mobile deep linking for 25+ platforms
- Link thumbnails (image alongside links)
- PIN-protected pages (4–8 digit PIN)
- QR code generation (downloadable SVG)
- Version history with rollback
- Embeddable widget (iframe embed on external sites)
- Zero-JS public pages — pure HTML/CSS, fast everywhere
- Privacy-first: no cookies, no tracking pixels, no third-party scripts
- Detailed analytics (Pro): click time series, top countries, referrers, per-link breakdown
- A/B testing (Pro): split traffic between two page variants, track clicks per variant
- Custom domains (Pro): connect your own domain with auto HTTPS
- Email collection (Pro): email signup blocks on pages
- Rich media embeds (Pro): YouTube, Spotify, SoundCloud
- Spotlight links (Pro): highlight one link with special styling
- Branding removal (Pro): hide "Powered by MeLinks" footer

## Integration options

### MCP Server (recommended for AI agents)

MCP endpoint: `https://melinks.co/mcp`
Discovery: `https://melinks.co/.well-known/mcp.json`

14 tools: `create_link_list`, `get_link_list`, `update_link_list`, `delete_link_list`, `export_link_list`, `import_link_list`, `get_qr_code`, `list_versions`, `rollback_version`, `get_analytics` (Pro), `create_ab_test` (Pro), `get_ab_test` (Pro), `conclude_ab_test` (Pro), `cancel_ab_test` (Pro)

### REST API

Base URL: `https://melinks.co/api/v1`
OpenAPI spec: `https://melinks.co/openapi.yaml`

## Authentication model

- Creating and reading link pages requires no authentication
- Updating and deleting requires a claim token (returned at creation) or an API key
- Users can claim pages by signing in with email (magic link) or passkey

## Pricing

- Free: up to 5 pages, built-in themes, all core features
- Pro (£3/month): unlimited pages, custom themes/fonts, custom domains, analytics, A/B testing, email collection, embeds, spotlight links, branding removal

## Agent Skill

melinks provides an AgentSkills-compatible skill that teaches AI agents when and how to use melinks. Install it for guided workflows, tool reference, and best practices.

- **Claude Code**: `git clone https://github.com/melinks/skill .claude/skills/melinks`
- **OpenClaw**: `openclaw skills install melinks` (or clone into `skills/melinks/`)
- **Claude.ai**: Download zip from https://github.com/melinks/skill → Settings > Features > Add Skill
- **Source**: https://github.com/melinks/skill

## Links

- [Full documentation for LLMs](https://melinks.co/llms-full.txt)
- [OpenAPI specification](https://melinks.co/openapi.yaml)
- [MCP server discovery](https://melinks.co/.well-known/mcp.json)
- [Agent skill source](https://github.com/melinks/skill)