API Documentation

Everything you need to connect your AI agent to LinkedInator's MCP servers. 14 tools across two servers. Full reference below.

Quick Start

Get your API key

Add the MCP servers to your agent

Add both servers to your Claude Desktop config, Cursor, or any MCP-compatible agent:

// Claude Desktop → Settings → Connectors → Add Custom Connector

// Server 1: Agentic Empire (9 tools)
https://agentic-empire-mcp-production.up.railway.app/mcp

// Server 2: Soul.md (5 tools)
https://soul-md-mcp-production.up.railway.app/mcp

Or add to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentic-empire": {
      "url": "https://agentic-empire-mcp-production.up.railway.app/mcp"
    },
    "soul-md": {
      "url": "https://soul-md-mcp-production.up.railway.app/mcp"
    }
  }
}

Make your first call

Open a new chat in Claude and try:

"Use the find_leads tool to find 10 Finance Directors in Sydney"

Claude will call the find_leads tool on the Agentic Empire server and return enriched lead data.

Authentication

MCP servers handle authentication automatically through the connector handshake. When you add the server URL to Claude Desktop or any MCP client, the connection is established without additional API key headers.

For programmatic access outside of MCP clients, include your API key in the request header:

// HTTP header for direct API access
Authorization: Bearer your_api_key_here

// Example with curl
curl -X POST https://agentic-empire-mcp-production.up.railway.app/mcp \
  -H "Authorization: Bearer lnk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"tool": "find_leads", "params": {"location": "Sydney"}}'

Rate Limits

Plan	Monthly Calls	Rate Limit	Price
Free Trial	100 calls	10 calls/min	Free (7 days)
Starter	500 calls	30 calls/min	$49/month
Growth	5,000 calls	60 calls/min	$199/month
Empire	Unlimited	120 calls/min	$799/month

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Tool Reference

14 tools across two MCP servers. Click any tool to see parameters, examples, and response formats.

Tools in this server

find_leads send_outreach get_campaign_status get_cash_runway get_burn_rate project_scenario detect_plateau trigger_physical_audit subscribe_to_alerts

find_leads

agentic-empire

Search for leads on LinkedIn by location, industry, seniority, and keywords. Returns enriched contact profiles ready for outreach.

Parameters

Name	Type	Required	Description
location	string	required	Target location (e.g. 'Sydney', 'London', 'New York')
industry	string	required	Target industry (e.g. 'Finance', 'Technology', 'Healthcare')
seniority	string	optional	Seniority level filter (e.g. 'Director', 'VP', 'C-Suite')
keywords	string	optional	Additional search keywords
limit	number	optional	Max results to return (default: 25, max: 100)

Example Call

find_leads({
  location: "Sydney",
  industry: "Finance",
  seniority: "Director",
  limit: 50
})

Example Response

{
  "leads": [
    {
      "id": "lead_8x7k2m",
      "name": "Sarah Chen",
      "title": "Director of Operations",
      "company": "Westpac",
      "location": "Sydney, Australia",
      "linkedin_url": "https://linkedin.com/in/sarachen",
      "email": "[email protected]"
    }
  ],
  "total": 50,
  "has_more": true
}

send_outreach

agentic-empire

Send a personalised outreach message to a lead. Linkedinator customises the template with lead data, sends via email, and logs the interaction.

Parameters

Name	Type	Required	Description
lead_id	string	required	The lead ID returned from find_leads
template	string	required	Message template with {name}, {company}, {title} placeholders
channel	string	optional	Delivery channel: 'email' (default) or 'linkedin_message'
subject	string	optional	Email subject line (email channel only)

Example Call

send_outreach({
  lead_id: "lead_8x7k2m",
  template: "Hi {name}, I noticed your work at {company}...",
  channel: "email",
  subject: "Quick question about {company}"
})

Example Response

{
  "status": "sent",
  "message_id": "msg_4n9p2q",
  "channel": "email",
  "delivered_at": "2026-03-23T09:15:00Z"
}

get_campaign_status

agentic-empire

Check the status of outreach campaigns. Returns open rates, reply rates, and per-lead delivery status.

Parameters

Name	Type	Required	Description
campaign_id	string	optional	Specific campaign ID (omit for all campaigns)
date_from	string	optional	Start date filter (ISO 8601)
date_to	string	optional	End date filter (ISO 8601)

Example Call

get_campaign_status({
  date_from: "2026-03-01",
  date_to: "2026-03-23"
})

Example Response

{
  "campaigns": [
    {
      "id": "camp_2k8m",
      "name": "Finance Directors Sydney",
      "sent": 50,
      "opened": 32,
      "replied": 8,
      "open_rate": "64%",
      "reply_rate": "16%"
    }
  ]
}

get_cash_runway

agentic-empire

Calculate your business cash runway based on current revenue, expenses, and growth rate. Returns months of runway and projected break-even date.

Parameters

Name	Type	Required	Description
monthly_revenue	number	required	Current monthly revenue in AUD
monthly_expenses	number	required	Current monthly expenses in AUD
cash_reserves	number	required	Total cash reserves in AUD
growth_rate	number	optional	Monthly revenue growth rate as decimal (e.g. 0.05 for 5%)

Example Call

get_cash_runway({
  monthly_revenue: 83000,
  monthly_expenses: 73000,
  cash_reserves: 150000,
  growth_rate: 0.03
})

Example Response

{
  "runway_months": 15,
  "monthly_burn": -10000,
  "break_even_date": "2027-06-15",
  "status": "healthy"
}

get_burn_rate

agentic-empire

Get the current burn rate across all business entities. Breaks down fixed vs variable costs and flags areas of concern.

Parameters

Name	Type	Required	Description
entity	string	optional	Business entity name (omit for all entities)
period	string	optional	Time period: 'monthly' (default), 'quarterly', 'annual'

Example Call

get_burn_rate({
  entity: "Vision PT St Leonards",
  period: "monthly"
})

Example Response

{
  "entity": "Vision PT St Leonards",
  "period": "monthly",
  "total_burn": 73000,
  "fixed_costs": 45000,
  "variable_costs": 28000,
  "top_expenses": [
    { "category": "Rent", "amount": 18000 },
    { "category": "Payroll", "amount": 35000 }
  ]
}

project_scenario

agentic-empire

Run financial projections with different growth scenarios. Model best case, worst case, and base case outcomes for any business entity.

Parameters

Name	Type	Required	Description
entity	string	required	Business entity to project
months	number	optional	Projection horizon in months (default: 12)
scenarios	array	optional	Array of growth rate scenarios to model

Example Call

project_scenario({
  entity: "AI Empire Ventures",
  months: 24,
  scenarios: [0.02, 0.05, 0.10]
})

Example Response

{
  "entity": "AI Empire Ventures",
  "projections": [
    { "scenario": "conservative (2%)", "revenue_month_24": 127000 },
    { "scenario": "base (5%)", "revenue_month_24": 265000 },
    { "scenario": "aggressive (10%)", "revenue_month_24": 730000 }
  ]
}

detect_plateau

agentic-empire

Analyse fitness or business metrics to detect plateaus. Returns whether progress has stalled and recommends adjustments.

Parameters

Name	Type	Required	Description
metric_type	string	required	'fitness' or 'business'
data_points	array	required	Array of {date, value} objects
threshold	number	optional	Plateau detection sensitivity (default: 0.02)

Example Call

detect_plateau({
  metric_type: "fitness",
  data_points: [
    { date: "2026-01-01", value: 78 },
    { date: "2026-02-01", value: 77.5 },
    { date: "2026-03-01", value: 77.3 }
  ]
})

Example Response

{
  "plateau_detected": true,
  "duration_weeks": 8,
  "recommendation": "Increase caloric deficit by 200kcal or add one HIIT session per week",
  "confidence": 0.85
}

trigger_physical_audit

agentic-empire

Trigger a comprehensive physical audit. Collects body composition, movement quality, and recovery metrics to generate a full report.

Parameters

Name	Type	Required	Description
client_id	string	required	Client identifier
measurements	object	required	Body measurements: weight, body_fat, chest, waist, hips
movement_scores	object	optional	Movement quality scores (squat, hinge, push, pull)

Example Call

trigger_physical_audit({
  client_id: "robbie",
  measurements: {
    weight: 76,
    body_fat: 12.5,
    chest: 100,
    waist: 82,
    hips: 95
  }
})

Example Response

{
  "audit_id": "aud_3k9m",
  "score": 82,
  "body_fat_status": "approaching_target",
  "target": 10,
  "estimated_weeks_to_target": 8,
  "recommendations": [
    "Maintain current deficit",
    "Add 1 refeed day per week"
  ]
}

subscribe_to_alerts

agentic-empire

Subscribe to automated alerts for business or fitness metrics. Get notified when KPIs cross thresholds you define.

Parameters

Name	Type	Required	Description
metric	string	required	Metric to monitor (e.g. 'revenue', 'body_fat', 'churn_rate')
condition	string	required	Alert condition: 'above', 'below', 'change_pct'
threshold	number	required	Threshold value that triggers the alert
channel	string	optional	Notification channel: 'email' (default), 'slack', 'webhook'

Example Call

subscribe_to_alerts({
  metric: "monthly_revenue",
  condition: "below",
  threshold: 70000,
  channel: "email"
})

Example Response

{
  "alert_id": "alert_7m2n",
  "status": "active",
  "metric": "monthly_revenue",
  "condition": "below 70000",
  "channel": "email"
}

Ready to connect your agent?

Get your API key, add the MCP servers, and your agent will have LinkedIn capabilities in under five minutes.