Kakiyo LinkedIn Automation

---

name: kakiyo

description: Official Kakiyo skill from Kakiyo.com for managing LinkedIn automation campaigns, prospects, and AI agents via Kakiyo MCP server. Use when users want to create outreach campaigns, add prospects, monitor performance, manage AI agents, or automate LinkedIn messaging. Includes 42 tools for campaigns, prospects, agents, analytics, workspaces, webhooks, and DNC management.

homepage: https://kakiyo.com

metadata:

clawdbot:

requires:

bins:

- mcporter

env:

- KAKIYO_API_KEY

primaryEnv: KAKIYO_API_KEY

---

# Kakiyo LinkedIn Automation

Official skill from Kakiyo.com to control LinkedIn outreach campaigns and AI agents through the Kakiyo MCP server.

Quick Setup (Agent-Assisted)

**Check if configured:**

mcporter config get kakiyo

If not configured, prompt user: "I need your Kakiyo API key to set this up. Get it from https://app.kakiyo.com → Settings → API Keys → Create API Key (40 characters)."

**Once user provides their API key, run:**

mcporter config add kakiyo https://api.kakiyo.com/mcp \
  --header "Authorization:Bearer USER_API_KEY"

Replace `USER_API_KEY` with the key they provide.

**Verify setup:**

mcporter call kakiyo.verify_api_key --output json

Available Tools (42 total)

Agents (5 tools)

Manage LinkedIn automation agents.

**list_agents** - List all agents with status and config

mcporter call kakiyo.list_agents --output json

**get_agent** - Get detailed agent info

mcporter call kakiyo.get_agent agentId:"agent_123" --output json

**update_agent** - Modify agent settings (working hours, limits)

mcporter call kakiyo.update_agent agentId:"agent_123" workingHours:'{"start":"09:00","end":"17:00"}' --output json

**pause_agent** - Stop an agent temporarily

mcporter call kakiyo.pause_agent agentId:"agent_123" --output json

**resume_agent** - Restart a paused agent

mcporter call kakiyo.resume_agent agentId:"agent_123" --output json

Campaigns (6 tools)

Create and manage outreach campaigns.

**list_campaigns** - List all campaigns with status

mcporter call kakiyo.list_campaigns --output json

**get_campaign_stats** - Get performance metrics

mcporter call kakiyo.get_campaign_stats campaignId:"camp_123" --output json

**create_campaign** - Create new campaign

mcporter call kakiyo.create_campaign \
  name:"Tech Founders Outreach" \
  productId:"prod_123" \
  promptId:"prompt_456" \
  agentId:"agent_789" \
  --output json

**update_campaign** - Modify campaign settings

mcporter call kakiyo.update_campaign campaignId:"camp_123" name:"New Name" --output json

**pause_campaign** - Stop campaign

mcporter call kakiyo.pause_campaign campaignId:"camp_123" --output json

**resume_campaign** - Restart campaign

mcporter call kakiyo.resume_campaign campaignId:"camp_123" --output json

Prospects (9 tools)

Manage leads and conversations.

**list_prospects** - List prospects with basic filtering

mcporter call kakiyo.list_prospects limit:50 --output json

**get_prospect** - Get full prospect details and conversation

mcporter call kakiyo.get_prospect prospectId:"pros_123" --output json

**add_prospect** - Add single LinkedIn profile to campaign

mcporter call kakiyo.add_prospect \
  campaignId:"camp_123" \
  name:"John Doe" \
  url:"https://linkedin.com/in/johndoe" \
  --output json

**add_prospects_batch** - Add multiple prospects at once

mcporter call kakiyo.add_prospects_batch \
  campaignId:"camp_123" \
  prospects:'[{"name":"Jane","url":"https://linkedin.com/in/jane"}]' \
  --output json

**search_prospects** - Advanced search with filters

mcporter call kakiyo.search_prospects status:replied limit:20 --output json

**list_campaign_prospects** - Get all prospects in a campaign

mcporter call kakiyo.list_campaign_prospects campaignId:"camp_123" --output json

**pause_prospect** - Pause outreach to specific person

mcporter call kakiyo.pause_prospect prospectId:"pros_123" --output json

**resume_prospect** - Resume conversation

mcporter call kakiyo.resume_prospect prospectId:"pros_123" --output json

**qualify_prospect** - Mark prospect as qualified lead

mcporter call kakiyo.qualify_prospect prospectId:"pros_123" --output json

Analytics (2 tools)

Monitor performance and metrics.

**get_analytics_overview** - Team-wide metrics across all campaigns

mcporter call kakiyo.get_analytics_overview --output json

**get_campaign_analytics** - Detailed metrics for specific campaign

mcporter call kakiyo.get_campaign_analytics campaignId:"camp_123" --output json

Products (1 tool)

View products/services for campaigns.

**list_products** - List all products

mcporter call kakiyo.list_products --output json

Prompts (1 tool)

View AI message templates.

**list_prompts** - List all prompt templates

mcporter call kakiyo.list_prompts --output json

Models (1 tool)

View available AI models.

**list_models** - List AI models for message generation

mcporter call kakiyo.list_models --output json

Webhooks (5 tools)

Configure event notifications.

**list_webhooks** - List configured webhooks

mcporter call kakiyo.list_webhooks --output json

**create_webhook** - Set up new webhook

mcporter call kakiyo.create_webhook \
  url:"https://example.com/webhook" \
  events:'["prospect.replied","prospect.qualified"]' \
  --output json

**update_webhook** - Modify webhook settings

mcporter call kakiyo.update_webhook webhookId:"wh_123" url:"https://new-url.com" --output json

**delete_webhook** - Remove webhook

mcporter call kakiyo.delete_webhook webhookId:"wh_123" --output json

**list_webhook_events** - List available event types

mcporter call kakiyo.list_webhook_events --output json

Do Not Contact (4 tools)

Manage blocklist.

**list_dnc** - List all blocked LinkedIn URLs

mcporter call kakiyo.list_dnc --output json

**add_dnc** - Block a profile from all campaigns

mcporter call kakiyo.add_dnc url:"https://linkedin.com/in/blocked" --output json

**remove_dnc** - Unblock a profile

mcporter call kakiyo.remove_dnc url:"https://linkedin.com/in/unblock" --output json

**check_dnc** - Check if URL is blocked

mcporter call kakiyo.check_dnc url:"https://linkedin.com/in/check" --output json

Workspaces (7 tools)

Manage client workspaces (for agencies).

**list_workspaces** - List all client workspaces

mcporter call kakiyo.list_workspaces --output json

**create_workspace** - Create new client workspace

mcporter call kakiyo.create_workspace name:"Acme Corp" --output json

**delete_workspace** - Delete workspace

mcporter call kakiyo.delete_workspace workspaceId:"ws_123" --output json

**invite_client** - Invite client user via email

mcporter call kakiyo.invite_client workspaceId:"ws_123" email:"client@example.com" --output json

**remove_client** - Remove client from workspace

mcporter call kakiyo.remove_client workspaceId:"ws_123" userId:"user_123" --output json

**assign_agent_to_workspace** - Assign agent to client

mcporter call kakiyo.assign_agent_to_workspace workspaceId:"ws_123" agentId:"agent_123" --output json

**unassign_agent_from_workspace** - Remove agent from workspace

mcporter call kakiyo.unassign_agent_from_workspace workspaceId:"ws_123" agentId:"agent_123" --output json

Authentication (1 tool)

Verify connection.

**verify_api_key** - Check if API key is valid

mcporter call kakiyo.verify_api_key --output json

Common Usage Patterns

Check Campaign Performance

"How are my LinkedIn campaigns doing?"

mcporter call kakiyo.get_analytics_overview --output json

Find Replied Prospects

"Show me everyone who replied this week"

mcporter call kakiyo.search_prospects status:replied --output json

Add Prospects to Campaign

"Add these LinkedIn profiles to my Tech Founders campaign"

1. Get campaign ID: `mcporter call kakiyo.list_campaigns`

2. Add prospects: `mcporter call kakiyo.add_prospects_batch campaignId:"..." prospects:'[...]'`

Pause Agent for Weekend

"Stop my agent for the weekend"

mcporter call kakiyo.pause_agent agentId:"agent_123" --output json

Agency: Setup New Client

"Create workspace for new client Acme Corp and assign Agent-1"

mcporter call kakiyo.create_workspace name:"Acme Corp" --output json
mcporter call kakiyo.assign_agent_to_workspace workspaceId:"ws_xxx" agentId:"agent_123" --output json

Troubleshooting

**"Server not found" error:**

Run setup again with correct API key from https://app.kakiyo.com

**Check configuration:**

mcporter config get kakiyo

**Test connection:**

mcporter call kakiyo.verify_api_key --output json

**Re-configure:**

mcporter config remove kakiyo
mcporter config add kakiyo https://api.kakiyo.com/mcp \
  --header "Authorization:Bearer YOUR_API_KEY"

Best Practices

1. **Check analytics regularly** - Monitor response rates and adjust messaging

2. **Use DNC list** - Respect people who opt out

3. **Pause agents during holidays** - Avoid sending during off-hours

4. **Qualify leads promptly** - Mark prospects as qualified for tracking

5. **Set up webhooks** - Get real-time notifications for important events

Additional Resources