Supports configuration management through environment variables, enabling secure storage of API keys and sensitive information needed for Tinder API integration.
Provides Facebook authentication functionality for logging into Tinder, allowing users to authenticate their Tinder account using their Facebook credentials.
Supports installation of the server via Git repository cloning as part of the setup process.
Hosts the repository for the MCP server, enabling users to clone the code and contribute to development.
Used for package management, installation of dependencies, and running development and production server instances.
Enables interaction with Tinder's API, providing tools for authentication, user profile management, getting match recommendations, and social interactions like liking, super-liking, or passing on profiles, sending messages, and boosting visibility.
The programming language used to implement the server, providing type safety and modern language features.
Tinder API MCP Server
A Model Context Protocol (MCP) server for the Tinder API, implemented in TypeScript.
Overview
This MCP server provides a standardized interface for interacting with the Tinder API. It handles authentication, request processing, rate limiting, caching, and error handling, making it easier to build applications that integrate with Tinder.
Features
- Authentication Management: Support for SMS and Facebook authentication methods
- Request Handling: Validation, transformation, and forwarding of API requests
- Response Processing: Parsing, validation, and transformation of API responses
- Rate Limiting: Protection against API rate limits
- Caching: Efficient caching of API responses
- Error Handling: Standardized error responses
- Security: Secure token storage and HTTPS communication
Architecture
The server follows a modular architecture with the following components:
- API Gateway: Entry point for MCP tools and resources
- Authentication Service: Handles user authentication flows
- Request Handler: Processes and forwards API requests
- Rate Limiter: Manages API rate limits
- Cache Manager: Caches API responses
- Error Handler: Standardizes error responses
Installation
- Clone the repository:
- Install dependencies:
- Create a
.env
file based on.env.example
: - Edit the
.env
file with your configuration settings.
Development
- Start the development server:
- Build the project:
- Run the production server:
- Run tests:
API Endpoints
Authentication
POST /mcp/auth/sms/send
: Send SMS verification codePOST /mcp/auth/sms/validate
: Validate SMS verification codePOST /mcp/auth/facebook
: Authenticate with FacebookPOST /mcp/auth/captcha
: Verify CAPTCHAPOST /mcp/auth/refresh
: Refresh authentication token
User
GET /mcp/user/:userId
: Get user profileGET /mcp/user/recommendations
: Get user recommendationsPUT /mcp/user/profile
: Update user profileGET /mcp/user/matches
: Get user matches
Interaction
POST /mcp/interaction/like/:targetUserId
: Like a userPOST /mcp/interaction/superlike/:targetUserId
: Super like a userPOST /mcp/interaction/pass/:targetUserId
: Pass on a userPOST /mcp/interaction/boost
: Boost profilePOST /mcp/interaction/message/:matchId
: Send messageGET /mcp/interaction/messages/:matchId
: Get messages for a match
MCP Tools and Resources
POST /mcp/tools
: Execute MCP toolGET /mcp/resources/:resourceId
: Access MCP resourceGET /mcp/info
: Get server information
MCP Tools
The server provides the following MCP tools:
authenticate_sms
: Authenticate user with SMSauthenticate_facebook
: Authenticate user with Facebookverify_captcha
: Verify CAPTCHA responselike_user
: Like a user profilesuper_like_user
: Super like a user profilepass_user
: Pass on a user profileboost_profile
: Boost user profile visibilityget_user_profile
: Get user profile informationget_recommendations
: Get potential matchesclear_cache
: Clear cacheget_rate_limits
: Get rate limit information
MCP Resources
The server provides the following MCP resources:
api-docs
: API documentationserver-status
: Server status information
Security Considerations
- Never hardcode secrets or API keys
- Use environment variables for sensitive information
- Implement proper authentication for all endpoints
- Use HTTPS for all communications
- Sanitize input and output data
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides a standardized interface for interacting with the Tinder API, handling authentication, request processing, rate limiting, caching, and error handling.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables integration with the Teamtailor API, allowing users to list, filter, and retrieve candidate information from their Teamtailor recruitment platform.Last updated -232TypeScriptMIT License
- -securityAlicense-qualityA server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.Last updated -28TypeScriptMIT License
- -securityFlicense-qualityA basic Model Context Protocol server implementation that demonstrates core functionality including tools and resources for AI chat applications.Last updated -Python
- -securityFlicense-qualityA Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.Last updated -1Python