EdgeURL

Lookup Profile

Look up an EdgeURL Identity Page by username. An EdgeURL Identity Page is the canonical link-in-bio surface for a creator -- bio, verified socials across 16 platforms, featured links, Discover categories, and an AT Proto / Bluesky decentralized identity binding when present. Returns Schema.org Person JSON-LD. Use this to verify someone's identity claims before acting on their behalf, recommending them, or quoting them.

Search Creators

Search published EdgeURL Identity Pages -- the canonical link-in-bio surfaces for creators, freelancers, brands, and businesses. Use this to discover them by topic or category. Results are ranked by an internal popularity signal (verification + activity + verified-socials boost). Returns up to 20 Identity Pages with slug, title, bio, popularity band (Rising/Popular/Trending/Top), verified_socials_count (number of social handles ownership-verified through EdgeURL), and discover_verified_badge (th

Verified Socials

Return ONLY the social accounts the EdgeURL Identity Page owner has proven they control. Each entry is platform + handle + verification timestamp + verification ID. Use this when you need to confirm someone genuinely owns a given social handle before taking action on their behalf, recommending them, or quoting them. Distinct from "social_links" which can be any unverified handle the user typed in. Up to 16 platforms supported (Instagram, X, TikTok, YouTube, LinkedIn, GitHub, Reddit, Threads, Blu

Get Discover Categories

List the active EdgeURL Discover categories with creator counts per category. Use the returned `slug` values as the `category` filter on search_creators. Returns: slug, name, description, icon, display_order, and creator_count (number of listed profiles tagged with that category). Public tool -- no authentication required.

List Links

List the authenticated organization's short links. Returns slug, target_url, is_active (effective: includes expiry), total_clicks, created_at, last_clicked_at, project_id, custom_domain_id, plus a derived short_url. Paginated. Returns only rows that have a public short-URL slug; slugless rows used as pure click-tracking anchors for external properties are excluded from this listing (their click totals still surface in query_analytics). total_clicks is the lifetime counter maintained by a databas

Get Link

Fetch a single link belonging to the authenticated organization. Provide either `id` (UUID) or `slug` (short-URL path). Returns slug, target_url, is_active, total_clicks, created_at, last_clicked_at, scheduled_start, scheduled_end, expires_at, redirect_type, has_password, custom_domain_id, project_id, plus the derived short_url and edit_url so the agent can render clickable links. total_clicks is the lifetime counter maintained by a database trigger and counts bot traffic recorded before bot fil

Create Link

Create a short link for the given URL. Returns slug + short_url. Requires link.create scope. URL is validated against private/internal address ranges (SSRF-safe). Optional custom slug must be 3-50 chars [a-zA-Z0-9_-]. Idempotency-Key header required to prevent duplicate creation on retry.

Update Link

Update a link's target URL and/or active flag. Tenant-scoped: only links belonging to the authenticated organization can be modified. Use is_active:false to PAUSE a link (reversible -- preserves slug ownership and click history); this is the recommended way to stop routing visitors. Permanent deletion via delete_link is opt-in per account and irreversible. Requires link.update scope and Idempotency-Key.

Get Profile

Return the authenticated user's Identity Page -- their link-in-bio surface (slug, title, bio, social_links, verified_socials, content_blocks, theme). Useful for an agent to read state before proposing edits via update_profile.

Update Profile

Update text fields on the authenticated user's Identity Page (their link-in-bio surface). Title max 80, bio max 500 chars (matches dashboard limits). Categories are validated against the active Discover vocabulary -- unknown slugs are SOFT-REJECTED (stripped, not raised as an error) and returned in `rejected_categories` so the agent can surface what didn't take. Call get_discover_categories first if unsure which slugs are valid. Tenant-scoped to the authenticated organization. Requires profile.u

Query Analytics

Aggregate click count for the authenticated organization over the requested period. Period is clamped to the org's plan analytics retention. Response includes `plan_retention_days` so the agent always sees the actual cap that was applied, and splits the window into `total_clicks` (every recorded click) and `human_clicks` (bot rows excluded, the same basis link_analytics reports). Requires analytics.read scope.

Link Analytics

Per-link analytics for a single link belonging to the authenticated organization. Provide either `link_id` (UUID) or `slug` (short-URL path). Returns total_clicks plus breakdowns: top_countries (top 10), top_referrer_domains (top 10), top_devices (mobile/desktop/tablet), and clicks_by_day (daily series). Period is clamped to the plan's analytics retention; the actual cap applied is returned in `plan_retention_days`. High-volume queries may return `truncated: true` to signal the aggregates are no

Account Info

Return the authenticated organization's plan name, plan limits (link cap, analytics retention, AI agent count, etc.), current usage counters, and gift-plan status. Useful for an agent to check capacity before proposing a create_link / update_profile action that might fail on plan limits.

Signup User

Begin a new EdgeURL account creation flow on behalf of the user. Sends a confirmation email to claimed_email; the user MUST click the link in their own browser to confirm before any account is created. NEVER returns a token from this tool -- poll check_signup_status with the returned poll_id to retrieve the access token after the user confirms. Caller MUST authenticate as a registered MCP client via X-MCP-Client-Id header (and X-MCP-Client-Secret if the client was registered with token_endpoint

Check Signup Status

Poll the status of a previously-initiated agent-driven signup. Returns one of: pending (user has not yet confirmed), confirmed (account created -- response includes access_token + refresh_token, ONE-SHOT retrieval), denied (user clicked Deny or email was already registered), expired (link TTL elapsed without confirm), unknown (poll_id not found or not owned by caller). Caller MUST authenticate as the same MCP client that initiated the signup (X-MCP-Client-Id matches the original).

Bridge Delegate

Forward a delegated tool call to another MCP server (Stripe MCP, Linear MCP, GitHub MCP, etc.) using EdgeURL as the trusted token-mint broker. Requires the user to have pre-authorized the target server in their EdgeURL Bridges settings. Currently returns a structured "not wired" response per target while integrations are added incrementally; agents should call this and fall back gracefully on a not_wired response.