heyreach-mcp: Cursor rule for Cursor

HeyReach MCP Server - Cursor Rules

Project Overview

This is a production-ready Model Context Protocol (MCP) server for HeyReach LinkedIn automation platform. It enables Claude Desktop and other MCP clients to manage campaigns, add leads, and automate LinkedIn outreach with comprehensive validation and error handling.

MCP Protocol Compliance

Current Protocol Version

• Protocol Version: 2025-03-26 (current)
• Revision: Current (ready for use)
• SDK: @modelcontextprotocol/sdk (TypeScript)

Supported MCP Features

• ✅ Tools: Full implementation with 12 production-ready tools
• ✅ Resources: Not implemented (not needed for this use case)
• ✅ Prompts: Not implemented (not needed for this use case)
• ❌ Sampling: Not implemented
• ❌ Logging: Should be implemented for production debugging
• ❌ Pagination: Should be implemented for large result sets

MCP Client Compatibility

Primary targets (verified working):

• ✅ Claude Desktop App: Full support (tools, prompts, resources)
• ✅ Cursor: Tools support
• ✅ Windsurf Editor: Tools support with AI Flow
• ✅ Continue: Tools, prompts, and resources support

Code Style & Architecture

TypeScript Standards

• Use strict TypeScript with proper type definitions
• Prefer explicit types over any
• Use Zod for runtime validation and schema definition
• Follow functional programming patterns where appropriate
• Use async/await for all asynchronous operations

MCP Server Architecture

// Proper MCP server structure
export class HeyReachMcpServer {
  private server: McpServer;
  private heyReachClient: HeyReachClient;
  
  constructor(config: HeyReachConfig) {
    this.server = new McpServer({
      name: 'heyreach-mcp-server',
      version: '1.1.7'
    });
    this.heyReachClient = new HeyReachClient(config);
    this.setupTools();
  }
}

Tool Definition Best Practices

// Correct tool definition pattern
this.server.tool(
  'tool-name',
  {
    // Zod schema - NO description field here
    param1: z.string().describe('Parameter description'),
    param2: z.number().optional().default(0).describe('Optional parameter')
  },
  async ({ param1, param2 }) => {
    try {
      // Implementation
      return createSuccessResponse(data, message);
    } catch (error) {
      return createErrorResponse(error.message);
    }
  }
);