Developers

API & MCP reference

Control LinkedMinds two ways: conversationally through the Claude MCP server, or programmatically through the REST API. Both share the same safety engine.

Overview

LinkedMinds exposes a Model Context Protocol (MCP) server and a REST API. Generate credentials from Settings → API Key inside your dashboard.

MCP for Claude

One URL, natural language

REST API

Campaigns, leads, analytics

Same safety

Limits apply to both

Connect to Claude (MCP)

Add the server to Claude in three steps.

1Go to Settings → API Key, open Claude MCP Credentials, and click Generate. Copy the Client Secret - it's shown once.
2In claude.ai → Settings → Connectors (or Claude Desktop → MCP Servers), choose Add custom MCP server.
3Enter the URL below and your credentials, then save.

https://mcp.linkedminds.in/mcp

Claude Desktop config.json alternative:

{
  "mcpServers": {
    "linkedminds": {
      "type": "streamable-http",
      "url": "https://mcp.linkedminds.in/mcp",
      "headers": { "Authorization": "Bearer <YOUR_CLIENT_SECRET>" }
    }
  }
}

MCP tools

Once connected, ask Claude in plain language - it calls these under the hood.

get_status()

Live campaign stats - connections, replies, acceptance and ban-risk.

find_leads()

Search LinkedIn by title, industry, location, company size and keywords.

find_leads_advanced()Pro+

Sales Navigator-grade filtering.

find_recruiter_leads()Enterprise+

Source candidates via Recruiter filters.

create_campaign()

Spin up a multi-step outreach sequence from a plain-English brief.

list_campaigns()

List all campaigns with their status and IDs.

pause_campaign()

Pause a running campaign.

resume_campaign()

Resume a paused campaign.

get_inbox()

Fetch replies across every connected account (Unibox).

reply_message()

Send an on-tone reply to a conversation.

update_icp()

Adjust your ideal-customer profile for targeting.

create_post()Standard+

Draft (and optionally schedule) a LinkedIn post.

REST API

Programmatic access to campaigns, leads, analytics and account status - available on Pro and Enterprise. Authenticate with a Bearer API key from Settings.

curl https://mcp.linkedminds.in/v1/status \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Method	Endpoint	Description
GET	/v1/status	Account & campaign metrics
GET	/v1/campaigns	List campaigns
POST	/v1/campaigns	Create a campaign
GET	/v1/leads	List / search leads
GET	/v1/inbox	Fetch replies

Authentication

One-way storage

Secrets are stored as bcrypt hashes (rounds=12). We can't recover the raw value - rotate to get a new one.

5-minute cache

Verified credentials are cached briefly so repeated calls don't hit the database every time.

Instant revocation

Rotate or revoke from Settings; the cache is flushed immediately.

Subscription gate

If your subscription lapses, credentials stop working until you renew.

Rate limits & safety

Whether you drive LinkedMinds through Claude or the API, actions run through the same human-like pacing engine - randomised delays (120–600s), burst windows and cool-down breaks. You can't send faster than your plan's monthly limit or your account's current warm-up phase allows.

See plan limits