Polar connector

[mattzcarey]

Add a connector for polar.sh the payments company.

Research their api to find the most used functionality. Evaluate the endpoints. Wrap them as tools.

For list endpoints you can convert them into search with the search utility function.

Make it production ready and tested.

[mattzcarey]

@claude work on this

[claude]

Claude finished @mattzcarey's task —— View job • claude/issue-63-20250821-2007 • Create PR ➔

---

✅ Polar Connector Implementation Complete

I've successfully created a comprehensive Polar connector for the MCP connectors repository! Here's what was implemented:

🔧 Connector Features

13 Tools Covering All Major Polar API Endpoints:

• Products: List, get individual products, search with full-text capabilities
• Customers: List, get, create customers, search by name/email
• Subscriptions: List with filtering (active status, customer, product), get individual subscriptions
• Checkouts: Create payment sessions, get checkout details
• Orders: List with filtering by customer, product, organization
• Benefits: List benefits (license keys, downloads, repository access)
• Organizations: List accessible organizations

🔍 Advanced Search Capabilities

• Implemented SEARCH_PRODUCTS and SEARCH_CUSTOMERS tools using the repository's lexical search utility
• Converts list endpoints to searchable functionality as requested
• Full-text search across product names/descriptions and customer names/emails
• Returns results with search scores for relevance ranking

🏗️ Technical Implementation

• Production-ready code with comprehensive error handling
• TypeScript interfaces for all Polar API response types
• Zod validation schemas for all tool parameters
• Dual environment support (production + sandbox)
• Proper authentication using Organization Access Tokens
• Follows repository conventions and coding standards

✅ Quality Assurance

• 15 comprehensive tests covering happy path, error cases, and edge scenarios
• All tests passing with proper mocking and assertions
• TypeScript compilation successful with no type errors
• Follows the repository's testing framework patterns (vitest + structured describe blocks)

📋 API Coverage

Based on research of real-world Polar usage patterns, the connector prioritizes the most commonly used endpoints:

1. Products - Core business offering management
2. Customers - User management and CRM functionality
3. Subscriptions - Recurring billing management
4. Checkouts - Payment flow initiation
5. Orders - Transaction history and fulfillment
6. Benefits - Digital product delivery (license keys, downloads, etc.)

🚀 Ready for Production

The connector is now ready to be integrated into the disco.dev platform and provides comprehensive coverage of Polar's payment infrastructure capabilities for SaaS and digital product businesses.

Files Created:

• packages/mcp-connectors/src/connectors/polar.ts - Main connector implementation
• packages/mcp-connectors/src/connectors/polar.spec.ts - Comprehensive test suite

---