Paid Business Data MCP Server
# Paid Business Data MCP Server
MCP server demonstrating paid x402 tools with Pyrimid Protocol integration.
## Features
- **Free preview tools** — `preview_enriched_search`, `preview_competitive_analysis`
- **Paid tools** — `buy_enriched_search` ($0.10), `buy_competitive_analysis` ($0.25)
- **HTTP 402 Payment Required** — standard x402 flow
- **Pyrimid catalog metadata** — discoverable by buyer agents
- **Groq AI enrichment** — llama-3.3-70b for business intelligence
## Quick Start
```bash
npm install
node src/http-server.js
```
## Endpoints
| Endpoint | Method | Price | Description |
|---|---|---|---|
| `/api/v1/health` | GET | Free | Health check |
| `/api/v1/products` | GET | Free | List all paid products |
| `/api/v1/preview/enriched-search?q=<query>` | GET | Free | Preview enriched search output |
| `/api/v1/paid/enriched-search?q=<query>` | GET | $0.10 | Full AI-enriched business search |
| `/api/v1/preview/competitive-analysis` | GET | Free | Preview competitive analysis |
| `/api/v1/paid/competitive-analysis` | POST | $0.25 | Full competitive analysis report |
## x402 Payment Flow
1. Call paid endpoint without `X-PAYMENT-TX` → get HTTP 402
2. Pay USDC via PyrimidRouter on Base
3. Retry with `X-PAYMENT-TX: <tx_hash>` header
4. Receive premium data
## License
MIT
TDQS
Scored across 5 tools
The free tools (company_overview, market_trend) and paid tools (enriched_search, competitive_analysis, financial_report) are reasonably distinct in purpose. However, enriched_search and competitive_analysis could overlap since enriched_search includes competitive analysis, potentially causing confusion about which to select for competitive needs.
Tool names follow a roughly consistent noun-based pattern (company_overview, market_trend, financial_report) with two verb-style names (enriched_search, competitive_analysis) mixed in. The mixed noun/verb convention is a minor deviation but names remain readable and predictable.
Five tools is well-scoped for a business data server. The split between free and paid tiers is clear and each tool serves a distinct purpose without bloating the surface.
The server covers overview, market trends, enriched search, competitive analysis, and financial reporting. However, gaps exist such as no tool for targeted financial data lookup (like a specific financial statement query) or industry-specific company comparisons beyond the paid search.