IFlnkib
Public API · MCP

Connect lnkib with a
public API and AI MCP

Most link-in-bio and comment tools only edit inside a web dashboard. lnkib ships a public REST API and MCP (Model Context Protocol) so external workflows and AI agents can drive Instagram automation and bio pages directly.

Public REST API

Send the key from Settings as the `X-API-Key` header to list and change accounts, media, automation rules, comments, raffles, logs, and bio pages.

Base URL

https://api.lnkib.com

Auth

Every `/api/v1` request needs the `X-API-Key` HTTP header. Issue keys in Settings → API Key, and optionally pin scopes and a single Instagram account.

Request example

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.lnkib.com/api/v1/accounts

OpenAPI spec (for AI & code generators)

A machine-readable spec with every endpoint's request and response schema, required scope (x-required-scopes) and error format. Give this URL to your AI agent or code generator so it calls the API accurately.

OpenAPI 3.1 (JSON)

https://api.lnkib.com/api/v1/openapi.json

Endpoints

GET/api/v1/accounts

List connected Instagram professional accounts

accounts:read

Show request & response schema

Loading schema...

GET/api/v1/accounts/:accountId/media

List Reels and posts for an account

accounts:read

Show request & response schema

Loading schema...

GET/api/v1/accounts/:accountId/rules

List comment/DM automation rules

rules:read

Show request & response schema

Loading schema...

POST/api/v1/accounts/:accountId/rules

Create or update an automation rule

rules:write

Show request & response schema

Loading schema...

PATCH/api/v1/rules/:ruleId/toggle

Enable or pause a rule

rules:write

Show request & response schema

Loading schema...

DELETE/api/v1/rules/:ruleId

Delete an automation rule

rules:write

Show request & response schema

Loading schema...

GET/api/v1/accounts/:accountId/comments

Fetch collected comments

comments:read

Show request & response schema

Loading schema...

POST/api/v1/accounts/:accountId/comments/raffle

Draw fair comment raffle winners

raffle:run

Show request & response schema

Loading schema...

GET/api/v1/accounts/:accountId/logs

Read auto-reply and DM execution logs

logs:read

Show request & response schema

Loading schema...

GET/api/v1/bio

List link-in-bio pages

bio:read

Show request & response schema

Loading schema...

POST/api/v1/bio

Create a bio page as a private draft (never published by this call)

bio:write

Show request & response schema

Loading schema...

PUT/api/v1/bio/:bioId

Update bio fields (publish state is never changed)

bio:write

Show request & response schema

Loading schema...

POST/api/v1/bio/:bioId/publish

Publish or unpublish a bio page

bio:publish

Show request & response schema

Loading schema...

POST/api/v1/bio/:bioId/links

Append a link to a bio page

bio:write

Show request & response schema

Loading schema...

GET/api/v1/booking-profiles

List booking pages

bookings:read

Show request & response schema

Loading schema...

GET/api/v1/bookings

List bookings (includes customer details)

bookings:read

Show request & response schema

Loading schema...

POST/api/v1/bookings

Add a manual booking (no customer message is sent)

bookings:write

Show request & response schema

Loading schema...

POST/api/v1/storage/presign

Create a presigned URL for bio image upload

bio:write

Show request & response schema

Loading schema...

AI agent MCP

The MCP server talks to the same public API. Connect it to Claude, Cursor, or other MCP clients to list accounts, write rules, and run raffles in conversation.

`@lnkib/mcp` is published on npm (source: github.com/lnkib-org/lnkib-mcp). Issue an API key in Settings, then add the config below to Claude or Cursor. The REST API is at `https://api.lnkib.com`.

Claude / Cursor config example

{
  "mcpServers": {
    "lnkib": {
      "command": "npx",
      "args": ["-y", "@lnkib/mcp"],
      "env": {
        "LNKIB_API_KEY": "YOUR_API_KEY",
        "LNKIB_API_BASE": "https://api.lnkib.com"
      }
    }
  }
}

MCP tools

list_accounts

List connected Instagram account UUIDs

list_media

List posts and Reels for an account

list_rules

List automation rules

upsert_rule

Create or update a rule (including per-keyword DMs)

toggle_rule

Enable or pause a rule

get_comments

Fetch collected comments

draw_comment_raffle

Draw comment raffle winners

get_logs

Read automation execution logs

list_bio_pages

List your Link-in-Bio pages

create_bio_page

Create a private bio draft

update_bio_page

Update a bio page (links/socials replace the whole list)

append_bio_link

Add one link to a bio page

set_bio_published

Publish or unpublish a bio page (needs bio:publish)

list_booking_profiles

List booking pages

list_bookings

List bookings (customer data)

create_manual_booking

Add a manual booking

Use your own AI

Connect Claude, ChatGPT or any MCP-capable assistant to lnkib and let it build your Link-in-Bio, read your bookings and add manual bookings. You pay your AI provider; lnkib only provides the connection.

Link-in-Bio and bookings do not require an Instagram connection.

Set up in 4 steps

1

Issue a key

Open Account Settings → API Keys. Start with the "Read-only" preset, or "Read + draft writes" if you want the AI to create bio drafts and manual bookings. Keep bio:publish off until you need it.

2

Connect MCP

Add the MCP config above to your AI app (Claude Desktop, Cursor, …) and restart it. The app runs `npx -y @lnkib/mcp` for you.

3

Ask in plain words

Use the example prompts below.

4

Review, then publish

AI-created pages are always private drafts. Open the draft in the Bio tab, check it, and publish it yourself.

Example prompts

Create a Link-in-Bio draft for my bakery "Mina's Baking Studio" with these links: class booking https://example.com/class, recipes https://example.com/recipe. Add my Instagram @mina.bakes and TikTok @mina. Keep it private and show me the result.

Show my pending bookings and tell me which days are busiest.

Add a manual booking: Jia Kim, 2026-11-20 at 14:00 for 30 minutes, note "beginner class for 2".

Permissions at a glance

bio:read · bookings:read

Read only. bookings:read includes customer names and contact details.

bio:write · bookings:write

Create bio drafts, edit pages, add links and add manual bookings. Nothing is published and no customer is messaged.

bio:publish

Make a page public or private again. Enable it only if you will approve each publish.

Safety checklist

  • Give each AI its own key, and revoke it when you stop using it.
  • Bookings contain personal data. Your AI provider sees whatever it reads, so do not enable bookings:read for tools you do not trust.
  • AI can make mistakes. Check names, prices and links before publishing.
  • Sending links or socials through the AI replaces the whole list. Ask it to read the page first.

Get started

01

Sign in to lnkib

Create a master account with social login, then connect an Instagram professional account if you need automation.

02

Issue an API key

In Settings, pick a name, scopes, and optional account pin. The raw key is shown only once.

03

Call REST or attach MCP

Call REST with `X-API-Key`, or paste the MCP JSON copied from Settings into your AI client.

Issue an API key now

Public API and MCP are available on the free plan. Keys are issued from Settings.

Go to Settings