Kakiyo 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:** ```bash 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:** ```bash 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:** ```bash 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 ```bash mcporter call kakiyo.list_agents --output json ```

**get_agent** - Get detailed agent info ```bash mcporter call kakiyo.get_agent agentId:"agent_123" --output json ```

**update_agent** - Modify agent settings (working hours, limits) ```bash mcporter call kakiyo.update_agent agentId:"agent_123" workingHours:'{"start":"09:00","end":"17:00"}' --output json ```

**pause_agent** - Stop an agent temporarily ```bash mcporter call kakiyo.pause_agent agentId:"agent_123" --output json ```

**resume_agent** - Restart a paused agent ```bash 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 ```bash mcporter call kakiyo.list_campaigns --output json ```

**get_campaign_stats** - Get performance metrics ```bash mcporter call kakiyo.get_campaign_stats campaignId:"camp_123" --output json ```

**create_campaign** - Create new campaign ```bash 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 ```bash mcporter call kakiyo.update_campaign campaignId:"camp_123" name:"New Name" --output json ```

**pause_campaign** - Stop campaign ```bash mcporter call kakiyo.pause_campaign campaignId:"camp_123" --output json ```

**resume_campaign** - Restart campaign ```bash mcporter call kakiyo.resume_campaign campaignId:"camp_123" --output json ```

### Prospects (9 tools) Manage leads and conversations.

**list_prospects** - List prospects with basic filtering ```bash mcporter call kakiyo.list_prospects limit:50 --output json ```

**get_prospect** - Get full prospect details and conversation ```bash mcporter call kakiyo.get_prospect prospectId:"pros_123" --output json ```

**add_prospect** - Add single LinkedIn profile to campaign ```bash 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 ```bash 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 ```bash mcporter call kakiyo.search_prospects status:replied limit:20 --output json ```

**list_campaign_prospects** - Get all prospects in a campaign ```bash mcporter call kakiyo.list_campaign_prospects campaignId:"camp_123" --output json ```

**pause_prospect** - Pause outreach to specific person ```bash mcporter call kakiyo.pause_prospect prospectId:"pros_123" --output json ```

**resume_prospect** - Resume conversation ```bash mcporter call kakiyo.resume_prospect prospectId:"pros_123" --output json ```

**qualify_prospect** - Mark prospect as qualified lead ```bash 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 ```bash mcporter call kakiyo.get_analytics_overview --output json ```

**get_campaign_analytics** - Detailed metrics for specific campaign ```bash mcporter call kakiyo.get_campaign_analytics campaignId:"camp_123" --output json ```

### Products (1 tool) View products/services for campaigns.

**list_products** - List all products ```bash mcporter call kakiyo.list_products --output json ```

### Prompts (1 tool) View AI message templates.

**list_prompts** - List all prompt templates ```bash mcporter call kakiyo.list_prompts --output json ```

### Models (1 tool) View available AI models.

**list_models** - List AI models for message generation ```bash mcporter call kakiyo.list_models --output json ```

### Webhooks (5 tools) Configure event notifications.

**list_webhooks** - List configured webhooks ```bash mcporter call kakiyo.list_webhooks --output json ```

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

**update_webhook** - Modify webhook settings ```bash mcporter call kakiyo.update_webhook webhookId:"wh_123" url:"https://new-url.com" --output json ```

**delete_webhook** - Remove webhook ```bash mcporter call kakiyo.delete_webhook webhookId:"wh_123" --output json ```

**list_webhook_events** - List available event types ```bash mcporter call kakiyo.list_webhook_events --output json ```

### Do Not Contact (4 tools) Manage blocklist.

**list_dnc** - List all blocked LinkedIn URLs ```bash mcporter call kakiyo.list_dnc --output json ```

**add_dnc** - Block a profile from all campaigns ```bash mcporter call kakiyo.add_dnc url:"https://linkedin.com/in/blocked" --output json ```

**remove_dnc** - Unblock a profile ```bash mcporter call kakiyo.remove_dnc url:"https://linkedin.com/in/unblock" --output json ```

**check_dnc** - Check if URL is blocked ```bash 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 ```bash mcporter call kakiyo.list_workspaces --output json ```

**create_workspace** - Create new client workspace ```bash mcporter call kakiyo.create_workspace name:"Acme Corp" --output json ```

**delete_workspace** - Delete workspace ```bash mcporter call kakiyo.delete_workspace workspaceId:"ws_123" --output json ```

**invite_client** - Invite client user via email ```bash mcporter call kakiyo.invite_client workspaceId:"ws_123" email:"[email protected]" --output json ```

**remove_client** - Remove client from workspace ```bash mcporter call kakiyo.remove_client workspaceId:"ws_123" userId:"user_123" --output json ```

**assign_agent_to_workspace** - Assign agent to client ```bash mcporter call kakiyo.assign_agent_to_workspace workspaceId:"ws_123" agentId:"agent_123" --output json ```

**unassign_agent_from_workspace** - Remove agent from workspace ```bash 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 ```bash mcporter call kakiyo.verify_api_key --output json ```

## Common Usage Patterns

### Check Campaign Performance "How are my LinkedIn campaigns doing?" ```bash mcporter call kakiyo.get_analytics_overview --output json ```

### Find Replied Prospects "Show me everyone who replied this week" ```bash 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" ```bash 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" ```bash 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:** ```bash mcporter config get kakiyo ```

**Test connection:** ```bash mcporter call kakiyo.verify_api_key --output json ```

**Re-configure:** ```bash 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