README and Gradio intro updates

README.md

@@ -17,17 +17,24 @@ short_description: MCP-native matchmaking to let your AI agents find you dates!
 ---
 
 # MatchMaiker: MCP-Native Dating Platform
-MatchMaiker is the first MCP-native dating platform, turning your AI agent into the ultimate wingman or wingwoman!
+**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
-This project demonstrates two key things:
- - 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!)
- - The infrastructure to help developers build these kinds of experiences in MCP-native ways, especially by integrating AgentPay (https://agentpay.me)
+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.
 
-If you want to jump straight into the video demo: https://www.loom.com/share/465724e5ef914860978ec590b461f525?sid=6a60fb9a-954f-4850-9394-550937692388
+### Video Demo
+Jump straight into the [video demo](https://www.loom.com/share/465724e5ef914860978ec590b461f525?sid=6a60fb9a-954f-4850-9394-550937692388).
 
-## Quickstart: Using it yourself
-Go ahead and add this to your MCP configuration (this will work in either Cursor or Claude).
+### Try it out
+Add this MCP configuration to your MCP Client to start using MatchMaiker yourself (verified working in Cursor and Claude).
 
 ```json
     "mcpServers": {
@@ -46,17 +53,29 @@ Go ahead and add this to your MCP configuration (this will work in either Cursor
     }
 ```
 
-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:
+**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 the ID for MatchMaiker MCP which identifies you to it.
-It starts off blank, and then once you create your profile for the first time, you 
+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 would be your AgentPay API key for the MatchMaiker MCP server that allows you to pay for its services.
-You'll notice a (sandbox) AgentPay API Key already in there; you can go ahead and feel free to use it.
-(Normally, of course, you would want to keep yours secret, as that allows others to use your balance!)
+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.
+
+---
 
-(List the tools and summary descriptions of each)
+Built by the AgentPay team. Questions or interested in chatting? Learn more: https://agentpay.me / Reach out: hello@agentpay.me

app.py

@@ -603,6 +603,30 @@ def print_headers(text, request: gr.Request):
 
 # --- Start of Gradio App Setup ---
 
+intro_markdown = gr.Markdown("""
+# 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, end-to-end agentic applications.
+
+**Why is this interesting?**
+- The user and product experience: a full, E2E, MCP-native application, from onboarding through monetization (and yes, it's a dating app!)
+- The infrastructure: actually building these kinds of MCP-native experiences, especially payments, by integrating [AgentPay](https://agentpay.me).
+
+**Key Features:**
+- **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:** Fetch full profiles for anyone you're interested in—as a demonstration of MCP-native payments, we integrated AgentPay here ($0.10 per profile).
+- **Send Messages:** Send messages to any prospective dates—again, as a further demonstration of MCP-native payments, we integrated AgentPay here as well ($1.00 per message).
+- **Check Messages:** Have full-fledged conversations with your dates via MatchMaiker, complete with a read/unread inbox at your fingertips.
+
+---
+
+*Built by the AgentPay team. [Learn more](https://agentpay.me) / hello@agentpay.me*
+""")
+
 #  Gradio interface for printing headers
 headers_demo = gr.Interface(
     fn=print_headers,
@@ -696,4 +720,7 @@ if __name__ == "__main__":
     base_dir = os.path.dirname(os.path.abspath(__file__))
     allowed_images_path = os.path.join(base_dir, "data", "profile_images")
 
-    demo.launch(mcp_server=True, allowed_paths=[allowed_images_path])
+    with gr.Blocks() as app:
+        intro_markdown
+        demo
+    app.launch(mcp_server=True, allowed_paths=[allowed_images_path])