Kakiyo Skill

Official Kakiyo skill from Kakiyo.com for managing LinkedIn automation campaigns, prospects, and AI agents via Kakiyo MCP server. Use when users want to crea...

Security Scan

The skill's requirements and runtime instructions are consistent with a Kakiyo CLI integration for managing LinkedIn outreach and only ask for the Kakiyo API key and a CLI binary (mcporter).

Purpose & Capability

Name/description, declared dependency (mcporter), and required environment variable (KAKIYO_API_KEY) align with a CLI-based Kakiyo MCP integration for campaign/agent/prospect management.

Instruction Scope

SKILL.md instructs the agent to configure mcporter with the user's Kakiyo API key and to call kakiyo.* commands. Instructions do not request unrelated files or other credentials. Nota bene: webhook creation and campaign/prospect commands will transmit data (prospect info, messages) to Kakiyo and may cause outbound LinkedIn activity — the agent could perform outreach if given permission.

Install Mechanism

No install spec (instruction-only). The skill assumes an existing mcporter binary; nothing is downloaded or written to disk by the skill itself.

Credentials

Only one credential is required (KAKIYO_API_KEY) and it is appropriate for the stated purpose. No unrelated secrets, config paths, or extra environment variables are requested.

Persistence & Privilege

always:false (normal). The skill can be invoked autonomously by the agent (platform default), which means if the agent is allowed autonomy it could create campaigns, add prospects, or send messages using the provided API key. This is expected for an automation skill but increases operational risk if not supervised.

Assessment

This skill is internally consistent with a Kakiyo CLI integration, but before installing: 1) Confirm you trust kakiyo.com and the mcporter CLI (verify its origin and install method on your system). 2) Only provide a Kakiyo API key you intend to allow to manage campaigns/agents — consider creating a scoped/test key if possible. 3) Be aware the agent (if allowed to act autonomously) can send LinkedIn outreach and create webhooks; restrict autonomy or test on a small sandbox campaign first. 4) Review and validate any webhook URLs you create to avoid leaking prospect data. 5) Rotate or revoke the API key if you stop using the skill.

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:"[e-mail]" --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

• Documentation: https://docs.kakiyo.com
• Dashboard: https://app.kakiyo.com
• MCP Server Details: https://docs.kakiyo.com/mcp-server
• API Reference: https://docs.kakiyo.com/api-reference