# Apex Operations Center - x402 Web3 MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Network: Base Mainnet](https://img.shields.io/badge/Network-Base%20Mainnet-blue)](https://base.org)
[![Protocol: x402](https://img.shields.io/badge/Protocol-x402%20Paywall-emerald)](https://x402.org)

Production-grade **Model Context Protocol (MCP)** server delivering paywalled Web3 micro-services powered by autonomous x402 payment challenges on Base Mainnet.

---

## ⚡ Live MCP Tools & Paywalled Services

| Tool Name | Method & Endpoint | Price (USDC) | Description |
|---|---|---|---|
| `pdf_data_parser` | `POST /api/v1/mcp/pdf-parser` | **$0.05 USDC** | Extract structured, schema-validated JSON from unstructured PDFs, invoices, or raw text documents. |
| `token_sentiment_analysis` | `GET /api/v1/crypto/sentiment` | **$0.02 USDC** | Real-time social sentiment scoring and mention breakdown across Farcaster, X, and Bountycaster feeds. |
| `github_repo_tracker` | `GET /api/v1/dev/github-tracker` | **$1.00 USDC** | Track star growth velocity, commit frequency, and active contributor metrics for any public GitHub repo. |

---

## 💳 x402 Micropayment Protocol Integration

The MCP server enforces an autonomous x402 HTTP paywall on Base Mainnet (Chain ID `8453`).

- **Deposit Address**: `0xd3347C84aacE6983ae55E1fBd795449869ECF99a`
- **USDC Token Contract**: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- **Challenge Header**: Requests without valid payment header return `HTTP 402 Payment Required` containing the paywall challenge payload.
- **Execution Header**: Supply `X-402-Payment-Proof: <tx_hash>` for instant execution.

---

## 🛠️ MCP Registry Manifests & Setup

This repository contains pre-configured discovery manifests for public MCP indexers:

- **Glama Manifest**: [`glama.json`](glama.json) - Conforms to `$schema: https://glama.ai/mcp/schemas/server.json`.
- **Smithery Manifest**: [`smithery.yaml`](smithery.yaml) - Schema definition for Smithery registry discovery.

### Quick Start

```bash
# 1. Install Backend Dependencies
pip install -r backend/requirements.txt

# 2. Start FastAPI Backend (Port 8000)
python -m uvicorn backend.main:app --host 0.0.0.0 --port 8000

# 3. Start Next.js Operations Center UI (Port 3000)
cd frontend && npm run dev
```

---

## 📄 License

Distributed under the MIT License.