README.md

---
title: MatchMaiker MCP
emoji: 🩵
tags:
 - mcp-server-track
 - agent-demo-track
 - dating
 - payments
 - agentpay
colorFrom: red
colorTo: green
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: true
short_description: The first MCP-native dating platform, with built-in payments
---

# MatchMaiker: MCP-Native Dating Platform
**Turn your AI agent into the ultimate wingman or wingwoman!**

MatchMaiker is the first MCP-native dating platform, demonstrating the power of fully embedded, E2E agentic applications.

## Overview
MatchMaiker aims to highlight two key points:

1. The exciting user and product experience that's possible with a full, end-to-end (E2E) MCP-native application, from user on-boarding through monetization (and it's a dating app, which is awesome!)
2. The infrastructure to actually build these kinds of MCP-native experiences, especially payments, by integrating [AgentPay](https://agentpay.me).

## Quickstart: Experience it for yourself
To experience it for yourself, you either jump into the video demo, or try it out in your own MCP client.

### Video Demo
Jump straight into the [video demo](https://www.loom.com/share/465724e5ef914860978ec590b461f525?sid=6a60fb9a-954f-4850-9394-550937692388).

### Try it out
Add this MCP configuration to your MCP Client to start using MatchMaiker yourself (verified working in Cursor and Claude Desktop).

```json
    "mcpServers": {
        "matchmaiker": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://agents-mcp-hackathon-matchmaiker.hf.space/gradio_api/mcp/sse",
                "--header",
                "X-AUTH-ID:<your_matchmaiker_auth_id>",
                "--header",
                "X-AGENTPAY-API-KEY:sk-apay-dev-LKsh90c8-0DvJjvROGUN5pXPkWEAjUcR9RDjQKFT130fCHRHlHIu"
            ],
            "env": {}
        }
    }
```

**MCP REMOTE**
We're using mcp-remote (https://www.npmjs.com/package/mcp-remote) here to facilitate our remote MCP server connection, and adding a couple of important headers, detailed below.

**X-AUTH-ID**
This is like your MatchMaiker auth token which lets you interact with your account.
You receive it once you create your profile, and you need to add it to your config for subsequent calls.
(Like any other auth token, you should keep it secret and safe!)

**X-AGENTPAY-API-KEY**
This is your AgentPay-issued API key for MatchMaiker MCP, allowing you to pay for its services with your AgentPay balance.
You'll notice a (sandbox) AgentPay API Key in the example config -- you can go ahead and feel free to use it.
(Normally, of course, you would want to keep yours secret and safe, as that allows others to use your balance!)

## Key Features
Here are the tools which make this possible:

- **New Profile:** Sign up, get your Auth ID, and answer some profile questions—the best part is that AI can help you with all the answers!
- **Update Profile:** Once you're ready, the agent will help you update your profile with your responses. It can do this multiple times, and helps you polish it.
- **Get Matches:** Based on your profile and preferences, MatchMaiker MCP will find you the best matches, and return summaries of each. You can always get more matches.
- **Full Profiles:** You can then fetch full profiles for anyone you're interested in—as a demonstration of MCP-native payments, we integrated AgentPay here, and charge $0.10 per profile.
- **Send Messages:** You can send messages to any prospective dates—again, as a further demonstration of MCP-native payments, we integrated AgentPay here as well, and charge $1.00 per message.
- **Check Messages:** Then, you can have full-fledged conversations with your dates via MatchMaiker if you wanted to, as it comes complete with a read/unread inbox at your fingertips.

---

Built by the AgentPay team. Questions or interested in chatting? Learn more: https://agentpay.me / Reach out: hello@agentpay.me