Description
Aimfox MCP Server provides seamless integration between Claude AI and Aimfox LinkedIn automation platform. Manage your LinkedIn outreach campaigns, leads, conversations, and analytics—all through natural conversation with Claude.
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
Connect via Claude.ai (OAuth)
1. Visit the Claude Connectors page
2. Find Aimfox in the available connectors
3. Click Connect
4. You'll be redirected to Aimfox to authorize the connection
5. Log in with your Aimfox credentials and click Authorize
6. You'll be redirected back to Claude with the connection active
7. Start using Aimfox tools in your conversations!
That's it! OAuth handles authentication automatically—no API keys needed.
---
Authentication
This server uses OAuth 2.0 authentication with PKCE for secure authorization.
OAuth Discovery
Claude automatically discovers OAuth configuration via the standard endpoint:
This returns all necessary OAuth metadata including authorization and token endpoints.
OAuth Flow
1. Claude fetches OAuth metadata from `/.well-known/oauth-authorization-server`
2. User is redirected to Aimfox authorization page
3. User logs in and grants permission
4. Aimfox redirects back to Claude with authorization code
5. Claude exchanges code for access token
6. Access token is used for all subsequent API requests
Supported Features
- Authorization Code Flow with PKCE (S256)
- Scopes: openid, profile, email
- Token Refresh: Automatic refresh when tokens expire
- Grant Types: authorization_code, refresh_token
Token Management
- Access tokens are automatically refreshed when expired
- Users can revoke access from their Aimfox dashboard at any time
- All tokens are securely stored and transmitted over HTTPS
Requirements
- Valid Aimfox account
- Active Aimfox subscription (any plan)
---
Available Tools (46 Tools)
📊 Account Management (3 tools)
- list_accounts - Get all connected LinkedIn accounts
- get_account_limits - Check daily action limits for an account
- set_account_limits - Update daily action limits
🎯 Campaign Operations (6 tools)
- 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 (8 tools)
- search_leads - Search and filter leads
- get_lead_details - Get complete lead information
- add_lead_note - Add a note to a lead
- update_lead_note - Update an existing note
- delete_lead_note - Remove a note
- add_lead_label - Tag a lead with a label
- remove_lead_label - Remove a label from a lead
- bulk_export_leads - Export multiple leads at once
🏷️ Label Management (4 tools)
- list_labels - Get all labels
- create_label - Create a new label
- update_label - Modify label details
- delete_label - Remove a label
📝 Template Management (5 tools)
- 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 (8 tools)
- list_conversations - Get all conversations
- get_conversation - Get conversation details
- send_message - Send a message
- mark_as_read - Mark conversation as read
- mark_as_unread - Mark conversation as unread
- archive_conversation - Archive a conversation
- unarchive_conversation - Restore an archived conversation
- get_conversation_messages - Get all messages in a conversation
📈 Analytics (2 tools)
- get_campaign_analytics - Get campaign performance metrics
- get_account_analytics - Get account activity metrics
🔔 Webhooks (4 tools)
- list_webhooks - Get all webhooks
- create_webhook - Create a new webhook
- update_webhook - Modify webhook settings
- delete_webhook - Remove a webhook
🚫 Blacklist (3 tools)
- list_blacklist - Get all blacklisted profiles
- add_to_blacklist - Block a profile
- remove_from_blacklist - Unblock a profile
🔑 Token Management (1 tool)
- check_api_token - Verify API token validity
---
Examples
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 days
with 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: "Access denied" error during authorization
Solutions:
- Verify your Aimfox account has API access enabled
- Contact [email protected] if your plan should include API access
Problem: Connection stops working after some time
Solutions:
- Token may have been revoked—reconnect from Claude integrations
- Check if your Aimfox subscription is still active
- Try disconnecting and reconnecting the integration
Tool Execution Issues
Problem: Tools not appearing in Claude
Solutions:
- Verify the connector is connected in Claude settings
- Try refreshing the page or restarting Claude
- Disconnect and reconnect the connector
Problem: Some tools return errors
Solutions:
- Verify your Aimfox account has access to that feature
- Check if you've hit API rate limits
- 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 Claude
- 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 Claude:
1. Go to Claude Connectors
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: https://app.aimfox.com
- 🐛 Issues: https://github.com/aimfox/mcp-server/issues