CryptoTwitter.Space x402 MCP Server

Provides pay-per-use access to premium CryptoTwitter.Space reports with automated revenue distribution.

CryptoTwitter.Space x402 MCP Serveris an entry for the "Agents in Action" hackathon, showcasing the power of autonomous, on-chain commerce usingx402pay and CDP Walletwith integratedMCP Server with x402 Payments.

This application acts as a micro-SaaS service, providinggated, pay-per-use access to premium CryptoTwitter.Space reports. It leveragesx402payfor seamless monetization andCDP WalletSmart Accounts toautomatically split and distribute revenueamong multiple stakeholders (host, content curator, and platform).

The innovation lies in its ability to empoweragentic commerce with automated payouts, demonstrating a complete revenue-generating loop for a proprietary data stream. Furthermore, it integrates withMCPto enable structured interaction, allowing users to query and purchase reports programmatically.

Currentlyhuman-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.

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 Serversolves 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 theCryptoTwitter.Space MCP Serverand enter a simple query:

Search:“What's going on with bitcoin?”

TheMCP Server with x402 Paymentsinstantly returns a list of timestamped, curated reports generated from live Twitter Spaces where Bitcoin was discussed.

- 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:

- TheHostthat ran the show receives 50% of the payment
- TheCuratorthat generated the report gets 30%
- ThePlatformretains 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.

- 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 incomingUSDCpayments are automatically split and disbursed to:

- Host (50%)
- Curator (30%)
- Platform (20%)

- 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.

This project directly tackles the hackathon's judging criteria:

- Effective use of both x402pay and CDP Wallet:We demonstratex402payfor 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 insrc/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 thex402 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 integratesMCP Server with x402 Paymentsto act as the primary interface for users, demonstrating how structured interaction can orchestrate complex on-chain financial workflows.

- Autonomous Payment:https://sepolia.basescan.org/tx/0x8eb9edbcf419afedd02425bc362c80360fc41b2166abb990198bb6d362cf4c88#eventlog
- Revenue Distribution:https://sepolia.basescan.org/tx/0x054e06160ef82508898b3fb4521f28828c5e5125e1c4fec8e6078cad24fec0bf#eventlog
- Clone the repository:

git clone https://github.com/benschiller/cts-x402-mcp.git cd cts-x402-mcp

# 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

{ "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" } } } }

-

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.

Run the server using the configured command:

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)

- Ensure the server is running before connecting the client.

Navigate your Aiven projects and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services

Yunxiao MCP Server provides AI assistants with the ability to interact with the Yunxiao platform.

Get prescriptive CDK advice, explain CDK Nag rules, check suppressions, generate Bedrock Agent schemas, and discover AWS Solutions Constructs patterns.

This AWS Labs Model Context Protocol (MCP) server for CloudTrail enables your AI agents to query AWS account activity for security investigations, compliance auditing, and operational troubleshooting.

Core AWS MCP server providing prompt understanding and server management capabilities.

Analyze CDK projects to identify AWS services used and get pricing information from AWS pricing webpages and API.

Query and analyze your Axiom logs, traces, and all other event data in natural language

Manage and interact with Microsoft Azure services.

Bastion: External Attack Surface Monitoring

Ask your AI assistant about your attack surface: run scans, catch expiring certificates and domains, triage findings, and generate reports.

Agent-ready global image CDN that AI agents can install and operate through MCP.