Description
Aimfox MCP Server provides seamless integration between AI Agents and the Aimfox LinkedIn automation platform. Manage your LinkedIn outreach campaigns, leads, conversations, and analytics - all through natural conversation with AI.
Features
Complete Campaign Control: List, analyze, pause/resume campaigns, add leads, and track performance metrics
Smart Lead Management: Search leads, add labels, create notes, and get detailed engagement history
Conversation Handling: View conversations, send messages, mark as read, and manage message reactions
Template Library: Create, update, and analyze message templates for optimal response rates
Analytics & Insights: Get campaign analytics, recent leads, and interaction data
Webhook Management: Set up and manage webhooks for real-time event notifications
Setup
Depending on your preferred AI agent, your setup process might be a bit different. Take a look at these articles to learn more:
Set up Claude x Aimfox MCP: https://help.aimfox.com/en/articles/13230384-aimfox-mcp-x-claude
Set up ChatGPT x Aimfox MCP: https://help.aimfox.com/en/articles/13230653-aimfox-mcp-x-chatgpt
To set everything up, you will need a valid Aimfox account with an active Subscription to any plan.
Token Management
- Access tokens are automatically refreshed when expired
- All tokens are securely stored and transmitted over HTTPS
Available tools for AI agents:
AI agents can access most tools available in our official Docs:
📊 Account Management
list_campaigns - Get all campaigns with filtering
get_campaign - Get detailed campaign information
create_campaign - Create a new campaign
update_campaign - Modify campaign settings (name, state)
add_profile_to_campaign - Add a LinkedIn profile to a campaign
remove_profile_from_campaign - Remove a profile from a campaign
add_multiple_profiles_to_campaign - Add multiple profiles with custom variables
🔧 Custom Variables
get_campaign_custom_variables - Get all custom variables for a campaign
get_target_custom_variables - Get custom variables for a specific target
add_custom_variables_to_target - Add custom variables to targets in a campaign
🎯 Campaign Operations
list_campaigns - Get all campaigns with filtering
get_campaign - Get detailed campaign information
update_campaign - Modify campaign settings
pause_campaign - Pause a running campaign
resume_campaign - Resume a paused campaign
delete_campaign - Delete a campaign
👥 Lead Management
search_leads - Search and filter leads
get_lead_details - Get complete lead information
get_lead_custom_variables - Get custom variables for a lead
search_leads_facets - Search lead facets (locations, companies, skills, etc.)
get_total_leads_count - Get total count of leads matching filters
add_label_to_lead - Tag a lead with a label
remove_label_from_lead - Remove a label from a lead
list_lead_notes - Get all notes for a lead
create_lead_note - Add a note to a lead
update_lead_note - Update an existing note
delete_lead_note - Remove a note
🏷️ Label Management
list_labels - Get all labels
create_label - Create a new label
update_label - Modify label details
delete_label - Remove a label
📝 Template Management
list_templates - Get all message templates
get_template - Get template details
create_template - Create a new template
update_template - Modify a template
delete_template - Remove a template
💬 Conversations
list_conversations - Get all conversations
get_conversation - Get conversation messages
get_lead_conversation - Get conversation URN for a specific lead
start_conversation - Start a new conversation
send_message - Send a message to a conversation
mark_conversation_read - Mark conversation as read
react_to_message - Add emoji reaction to a message
edit_message - Edit a sent message
delete_message - Delete a message
📈 Analytics
get_campaign_analytics - Get campaign performance metrics
get_account_analytics - Get account activity metrics
🔔 Webhooks
list_webhooks - Get all webhooks
create_webhook - Create a new webhook
update_webhook - Modify webhook settings
delete_webhook - Remove a webhook
🚫 Blacklist
list_blacklist - Get all blacklisted profiles
add_to_blacklist - Block a profile
remove_from_blacklist - Unblock a profile
list_blacklist_companies - Get all blacklisted companies
add_companies_to_blacklist - Block multiple companies
remove_company_from_blacklist - Unblock a company
🔑 Token Management
generate_login_token - Generate a login token for whitelabel access
🏢 Workspaces (JWT auth only)
list_workspaces - Get all workspaces for the authenticated user
Example prompts
Here are a few prompt examples for some common use-cases.
Campaign Analytics
Show me the performance analytics for all my active campaigns. Which ones have the highest reply rates?
Lead Search
Find all leads who replied to my messages this week but haven't been labeled yet. Suggest appropriate labels for each.
Bulk Operations
List all campaigns that have been running for more than 30 dayswith less than 5% reply rate. Suggest which ones should be paused.
Conversation Management
Show me all unread conversations from the last 3 days. Summarize what each lead is asking about.
Template Optimization
Analyze all my message templates and tell me which ones have the best response rates. Suggest improvements for underperformers.
Troubleshooting
OAuth / Connection Issues
Problem: Authorization fails or times out
Solutions:
- Ensure you're logged into your Aimfox account
- Check that your Aimfox subscription is active
- Try clearing browser cookies and reconnecting
- Disable browser extensions that may block redirects
Problem: Connection stops working after some time
Solutions:
- Token may have been revoked-reconnect from AI agent settings
- Check if your Aimfox subscription is still active
- Try disconnecting and reconnecting the integration
Tool Execution Issues
Problem: Tools not appearing in AI agent
Solutions:
- Verify the connector is connected in the AI agent settings
- Try refreshing the page or restarting the AI agent
- Disconnect and reconnect the connector
Problem: Some tools return errors
Solutions:
- Verify your Aimfox account has access to that feature
- Contact [email protected] if the issue persists
Performance Issues
Problem: Requests are slow
Solution:
- First connection takes longer as tools are being fetched. Subsequent requests will be faster.
Privacy & Security
Data Access
- Aimfox MCP only accesses data you explicitly request through the AI agent
- No data is stored by the MCP server - it acts as a pass-through to the Aimfox API
- All communication is encrypted via HTTPS
Revoking Access
To disconnect Aimfox from the AI agent:
1. Go to your AI agent connector settings
2. Find Aimfox and click Disconnect
Privacy Policy
See our privacy policy: https://aimfox.com/privacy
Support
📧 Email: [email protected]
📚 Documentation: https://docs.aimfox.com
💬 Live Chat: Click the "Intercom Chat" button in your dashboard navigation anywhere on https://app.aimfox.com