Connect LedaChat to Claude and other AI agents

Set up LedaChat's MCP server in Claude, Claude Code, Codex or Cursor, then create and run Instagram comment to DM automations by asking your AI agent.

MCP server URL

https://app.ledachat.com/mcp

Streamable HTTP. Sign-in is OAuth with Google, so there's no token to paste.

LedaChat is a free, open-source Instagram comment to DM tool. Its MCP server lets an AI agent do anything the app does: create an automation for your latest reel, put it live, pause it, or tell you who engaged. Connect it once, then ask in plain words, for example “Set up a comment to DM on my latest reel. When someone comments GUIDE, send them my guide link.”

Claude (claude.ai and Claude Desktop)

  1. Open Add custom connector in Claude. The name and URL are filled in. Or go to Settings, then Connectors, choose Add custom connector, and paste https://app.ledachat.com/mcp.
  2. Choose Connect and sign in with Google. A new account is created the first time.
  3. On the consent screen, choose whether Claude may make changes or only read.

On a Team or Enterprise plan, an owner may need to add the connector for the organization first.

Claude Code

With the plugin (recommended)

LedaChat's GitHub repository is a Claude Code plugin marketplace. In Claude Code, run:

/plugin install ledachat --marketplace kingscrosslabs/ledachat

On older versions of Claude Code, add the marketplace first:

/plugin marketplace add kingscrosslabs/ledachat
/plugin install ledachat@ledachat

Then type /mcp, pick plugin:ledachat:ledachat and choose Authenticate. Update later with /plugin update ledachat@ledachat.

Without the plugin

claude mcp add --transport http ledachat https://app.ledachat.com/mcp

Then type /mcp in Claude Code and choose Authenticate.

Codex

codex mcp add ledachat --url https://app.ledachat.com/mcp
codex mcp login ledachat

Codex loads MCP tools when a session starts, so start a new session after signing in.

Cursor

Add LedaChat to Cursor, or add this to mcp.json, then sign in when Cursor asks:

{
  "mcpServers": {
    "ledachat": {
      "url": "https://app.ledachat.com/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Add LedaChat to VS Code, or run MCP: Add Server from the Command Palette, choose HTTP and paste https://app.ledachat.com/mcp. Start the server from the MCP view, then sign in when VS Code asks.

ChatGPT, Perplexity and other clients

Any client that supports remote MCP servers with OAuth works with the server URL above. After you sign in to LedaChat, the Connect to AI Agent page in the app has a step-by-step guide for each client, with your URL filled in.

Clients that can't sign in with OAuth can send Authorization: Bearer adc_... with an API token from that page. Tokens can be read only, and can expire after 30, 90 or 365 days.

Check the connection

Ask your agent to call get_workspace. It says who is signed in, which Instagram account is connected and which plan you're on. If no account is connected yet, the agent gives you a one-time link to connect one.

Tools

ToolTypeWhat it does
get_workspaceReadWho is signed in, the connected Instagram account, automation counts and the plan.
connect_instagramWriteA one-time link for connecting an Instagram account, when none is connected yet.
list_automationsReadEvery automation, with its trigger, post, status and stats.
get_automationReadEverything about one automation: trigger, replies, DMs, status and stats.
list_postsReadRecent posts and reels, to pick the post an automation runs on.
list_storiesReadLive stories, for story reply automations.
list_audienceReadWho engages with your automations, most engaged first.
create_automationWriteCreates a draft. Nothing runs until it goes live.
update_automationWriteChanges some fields of an automation and keeps the rest.
go_liveWriteStarts an automation after checking every field.
pause_automationWriteStops an automation.
duplicate_automationWriteCopies an automation into a new draft.
delete_automationWriteDeletes an automation and its history. Can't be undone.
message_earlier_commentsWriteCounts, then (once you agree) messages people who commented in the last 24 hours, before the automation went live.
reset_runsWriteForgets who an automation has messaged, so they can trigger it again. Handy for testing.

New automations are always drafts. Tools use the same checks as the editor in the app, so an automation your agent puts live passes the same validation. Going live and messaging earlier comments send real DMs from your Instagram account, so your agent should confirm them with you first.

Permissions and disconnecting

  • A connection only reaches your own LedaChat account and its Instagram account.
  • Turn off changes on the consent screen for a read-only connection. Write tools then return an error.
  • Disconnect any client, or revoke an API token, on the Connect to AI Agent page in the app.

Self-hosting

If you run your own copy of LedaChat, its MCP server is at https://<your-domain>/mcp. Use that URL in the steps above. The plugin points at the hosted LedaChat, so use claude mcp add instead. See the README on GitHub.

Support

Questions or problems: hello@kingscrosslabs.com. Back to the MCP overview.