CryptoTwitter.Space x402 MCP Server
🚀 Agents in Action Hackathon Entry
CryptoTwitter.Space x402 MCP Server is an entry for the "Agents in Action" hackathon, showcasing the power of autonomous, on-chain commerce using x402pay and CDP Wallet with integrated MCP Server with x402 Payments.
✨ Project Overview
This application acts as a micro-SaaS service, providing gated, pay-per-use access to premium CryptoTwitter.Space reports. It leverages x402pay for seamless monetization and CDP Wallet Smart Accounts to automatically split and distribute revenue among multiple stakeholders (host, content curator, and platform).
The innovation lies in its ability to empower agentic commerce with automated payouts, demonstrating a complete revenue-generating loop for a proprietary data stream. Furthermore, it integrates with MCP to enable structured interaction, allowing users to query and purchase reports programmatically.
Currently human-in-the-loop, this system is designed to evolve toward full autonomy in future iterations driven by an AI character with a unique personality, rich narrative, and compelling backstory on platforms such as Virtuals or Eliza.
💡 Problem Solved
In crypto, speed to signal is everything—but human traders can’t listen to every live conversation, and AI tools lack the context to know what matters most in real time.
What’s missing is a co-pilot agent: one that understands the trader’s intent, listens across live audio, extracts critical information, and delivers it at the exact moment it's needed—before the market reacts.
But the deeper problem is economic: valuable signals are being shared in public forums, but there’s no incentive for hosts, speakers, or curators to surface, structure, and distribute that information. The trader suffers because high-signal alpha is lost in the noise because the market has no mechanism to reward those who find it first.
CryptoTwitter.Space x402 MCP Server solves the trader's problem by turning information into a monetizable asset class. Paid Alpha Reports are instantly revenue-shared via smart contracts between the Space host, the report curator, and the platform—creating a new incentive economy around signal discovery. This is the foundation of InfoFi—a financial layer for real-time information.
⚙️ Use Case: Searching for Bitcoin Alpha
A crypto trader wakes up to a fast-moving market and wants to catch up on overnight developments.
Instead of scrolling endlessly through X or listening to replays of Twitter Spaces, they interact with the CryptoTwitter.Space MCP Server and enter a simple query:
Search: “What's going on with bitcoin?”
The MCP Server with x402 Payments instantly returns a list of timestamped, curated reports generated from live Twitter Spaces where Bitcoin was discussed.
Each report includes:
- Key quotes and topic summaries
- Bullish or bearish sentiment classifications
- Links to the original audio for verification
- Speaker breakdowns and emerging narrative tags
They pay a small fee to unlock the full report. Instantly:
- The Host that ran the show receives 50% of the payment
- The Curator that generated the report gets 30%
- The Platform retains 20%
By the end of the session, the trader has context others missed—and the ecosystem that surfaced the signal gets rewarded. The incentive flywheel turns.
🌟 Key Features
- Pay-per-Use Content Access (x402pay): Monetizes access to premium CryptoTwitter.Space reports on a per-view basis.
- Automated Revenue Distribution (CDP Wallet Smart Account): Implements a full payment loop where incoming
USDCpayments are automatically split and disbursed to:- Host (50%)
- Curator (30%)
- Platform (20%)
- Composable & Modular Logic: Designed for reusability, demonstrating a clear separation of concerns between payment handling and distribution.
- Structured Interaction (MCP): Integrates with MCP Server with x402 Payments to provide a programmatic interface for querying and accessing paid reports.
- Real-World Relevance: Solves a tangible need for creators and platforms seeking to monetize digital assets and manage payouts efficiently on-chain.
📺 Demo
🛠️ Technologies Used
- x402pay: For seamless pay-per-use monetization.
- Coinbase Developer Platform (CDP) Wallet: For secure, programmable smart accounts and automated crypto flows.
- Express.js: Backend API server (
src/x402ExpressServer.ts). - TypeScript / Node.js
- MCP Server with x402 Payments: For structured interaction and programmatic access to reports.
- viem: For Ethereum interaction utilities.
🏆 How it Addresses Judging Criteria
This project directly tackles the hackathon's judging criteria:
- Effective use of both x402pay and CDP Wallet: We demonstrate
x402payfor charging users per report andCDP Walletto manage the subsequent crypto flows, including splitting and disbursing funds automatically to multiple recipients. - Completeness of payment loop: revenue in → payment out: The system fully automates the process from a user making a payment via x402 to the subsequent distribution of funds to the host, curator, and platform wallets via CDP Wallet.
- Real-world relevance: solves an actual need or use case: This project delivers a tangible edge to traders by surfacing real-time alpha from live audio conversations—insights they would otherwise miss. At the same time, it creates an incentive structure that rewards those who surface and structure valuable information, including Space hosts, report curators, and the platform itself. This aligns economic incentives across the entire information supply chain, turning signal discovery into a self-sustaining marketplace.
- Composability: reusable flows, templates, or modular logic: The core payment and distribution logic is encapsulated in
src/smartDistribution.ts, making it reusable. The Express server provides a clear API boundary. - Creativity: novel agents or new financial primitives: By combining pay-per-use access with automated, multi-party on-chain distribution orchestrated by the x402 Express Server, it creates a novel financial primitive for API monetization.
- Technical execution: clean, working code with a video demo: The codebase is well-structured, functional, and demonstrated via a comprehensive video.
- Effective and creative use of MCP: The project fully integrates MCP Server with x402 Payments to act as the primary interface for users, demonstrating how structured interaction can orchestrate complex on-chain financial workflows.
💰 Verifable On-chain Payments
- Autonomous Payment: https://sepolia.basescan.org/tx/0x8eb9edbcf419afedd02425bc362c80360fc41b2166abb990198bb6d362cf4c88#eventlog
- Revenue Distribution: https://sepolia.basescan.org/tx/0x054e06160ef82508898b3fb4521f28828c5e5125e1c4fec8e6078cad24fec0bf#eventlog
⚙️ Local Setup (for Judges)
To run the server locally:
- Clone the repository:
git clone https://github.com/benschiller/cts-x402-mcp.git cd cts-x402-mcp - Install dependencies:
npm install - Configure Environment Variables:
Copy the example file to get started:
cp .env.example .env.envand populate it with your specific API keys and addresses:# Example .env content - FILL IN YOUR ACTUAL VALUES # x402 Express Server (Smart Account) RECEIVING_WALLET_ADDRESS=0x... # x402 User Agent PRIVATE_KEY=... # CDP Smart Account CDP_API_KEY_ID=... CDP_API_KEY_SECRET=... CDP_WALLET_SECRET=... # CDP Payouts HOST_ADDRESS=0x... CURATOR_ADDRESS=0x... PLATFORM_ADDRESS=0x... SMART_ACCOUNT_ADDRESS=0x... # USDC on Base Sepolia USDC_CONTRACT_ADDRESS=0x036CbD53842c5426634e7929541eC2318f3dCF7e # Reports Base URL (do not change for hackathon) REPORTS_API_BASE=https://cryptotwitter.space - Run the server:
The server will start onnpm run start:expresshttp://localhost:4021.
Setting Up MCP Client (e.g., Claude or Cursor)
To connect an MCP client like Claude or Cursor to the MCP Server with x402 Payments, follow these steps:
1. Configure x402McpServer.json
Ensure your src/x402McpServer.json file contains the following configuration:
{
"mcpServers": {
"cts-reports-x402": {
"autoApprove": [
"search-reports",
"browse-reports",
"get-report-resource"
],
"timeout": 60,
"type": "stdio",
"command": "node",
"args": [
"dist/x402McpServer.js" // Path to your compiled server file
],
"env": {
"PRIVATE_KEY": "your_private_key_here"
}
}
}
}
2. Required Adjustments
-
Path to Server File:
Update"dist/x402McpServer.js"to point to your actual compiled server file (e.g.,"build/x402McpServer.js"if using a different build directory). -
Private Key:
Replace"your_private_key_here"with the private key of the wallet handling x402 payments.
3. Start the MCP Server
Run the server using the configured command:
node dist/x402McpServer.js
4. Connect Your MCP Client
Point your MCP client (e.g., Claude or Cursor) to this configuration to enable interaction with the server. The client should now be able to:
- Search reports (
search-reports) - Browse reports (
browse-reports) - Retrieve paid content (
get-report-resource)
Notes
- Ensure the server is running before connecting the client.