# MiniPages

> MiniPages is an AI-powered tool for creating link-in-bio mini pages.

## What is MiniPages?

MiniPages lets creators instantly generate beautiful, customizable mini pages for their link-in-bio. Just describe your style, add your links, and AI creates your perfect page — no coding needed.

MiniPages is also available as an MCP (Model Context Protocol) connector, so you can create, edit, delete and list your pages directly from Claude or any MCP-compatible AI agent using natural language.

## Key Features

- AI-generated mini pages from a text prompt
- Multiple themes and color palettes
- Custom links with emoji support
- Profile pictures and background images
- Bio text and personalized branding
- Unique shareable URL (minipages.cloud/username)
- MCP connector for managing pages via AI agents

## Use Cases

- TikTok, Instagram, and YouTube creators
- Small businesses and freelancers
- Anyone who needs a quick, stylish link-in-bio page
- Managing your link-in-bio page through Claude or other MCP agents

## MCP Connector

MiniPages can be added as a connector in Claude.ai (or any MCP-compatible client).

- MCP Endpoint: https://tfrfkhroqrltcjjyxkmg.supabase.co/functions/v1/mcp
- MCP Endpoint (subdomain): https://mcp.minipages.cloud
- Authorization: OAuth 2.1 + PKCE
- Discovery: https://minipages.cloud/.well-known/oauth-authorization-server
- Protected Resource: https://minipages.cloud/.well-known/oauth-protected-resource

Users sign in once with Google through the connector. All actions are scoped to the authenticated user.

## Available MCP Tools

### create_minipage
Creates a new mini page for the authenticated user. `theme_style` is free-form — the server auto-generates a polished, vibrant color palette using the same AI engine as the web app.
Parameters: username, creator_name, bio_text, links, theme_style (free-form), emoji_style, colors (optional override), button_text_color (optional)

### edit_minipage
Edits an existing page owned by the authenticated user.
Parameters: username, creator_name, bio_text, links, theme_style, emoji_style, colors

### get_minipage
Returns full current data for a single page owned by the authenticated user. Use before edit_minipage to read existing values.
Parameters: username

### delete_minipage
Deletes a page owned by the authenticated user.
Parameters: username

### list_my_minipages
Lists all pages owned by the authenticated user. No parameters.

### get_next_inquiry
Returns the next best undelivered inquiry (pure read — does not mark delivered). If AI scoring is unavailable, returns `{ inquiry: null, scoring_unavailable: true }`.

### reply_to_inquiry
Stores a reply to an inquiry. Returns `sender_email` so the agent can hand off to a Gmail-style MCP. Does NOT mark delivered.

### mark_inquiry_delivered
Call AFTER reply_to_inquiry succeeds (and the email is actually sent) to mark the inquiry as delivered. Parameters: username, inquiry_id.

### get_analytics
Returns visitor analytics for an owned page. Parameters: username, date_range.

### import_links_from_url
Fetches a public link-in-bio page and extracts only the user's outbound links as `[{label, url}]`. Does NOT copy design, colors, or layout. Requires explicit ownership confirmation.
Parameters: url, confirmed (must be true). The agent MUST present the checkbox "☐ I confirm this link in bio belongs to me" and wait for explicit user confirmation before calling. Each successful call logs the authenticated user_id and confirmed_at as an ownership attestation.

## Agent Usage Rules

When acting on a user's MiniPage via this MCP, AI agents MUST follow these rules:

1. **Prefer `get_minipage` over `list_my_minipages`.** Always try `get_minipage` first using a guessed slug (e.g. the name or handle the user mentioned). Only fall back to `list_my_minipages` if `get_minipage` returns not found or the user clearly has multiple pages and the target is ambiguous. This avoids exposing other pages the user owns.

2. **Background image overrides colors.** Before applying any color or `theme_style` change via `edit_minipage`, call `get_minipage` and check `background_image_url`. If it is set, do NOT silently change colors — the background image will visually override them. Tell the user the background image must be removed first via https://minipages.cloud, and wait for confirmation before proceeding.

## Theme Styles

- minimal clean
- bold vibrant
- pastel soft
- dark elegant
- retro warm
- Custom freetext descriptions are supported (e.g. "pink purple background with touches of blue")

## Links

- Website: https://minipages.cloud
- MCP Endpoint: https://tfrfkhroqrltcjjyxkmg.supabase.co/functions/v1/mcp
- MCP Endpoint (subdomain): https://mcp.minipages.cloud
- Privacy Policy: https://minipages.cloud/privacy
- Terms of Service: https://minipages.cloud/terms