AgentLayer MCP Server

A Model Context Protocol (MCP) server providing real-time AI infrastructure data via TypeScript + Hono on Cloudflare Workers.

Overview

AgentLayer MCP Server exposes 5 endpoints for AI agent consumption:

Endpoint	Description
/llm-costs	Real-time LLM pricing data across providers
/model-benchmarks	Model performance benchmarks and comparisons
/api-deprecations	Track deprecated API versions and migration paths
/quality-scores	AI model quality scores with sentiment analysis
/agent-spend	Agent API spend tracking with x402 micropayment support

Features

• Authentication: API key auth on all endpoints
• Rate Limiting: Configurable per-API-key limits
• Usage Logging: Full request/response logging
• Error Handling: Comprehensive error handling with meaningful responses
• x402 Micropayments: Native support for x402 payment protocol
• Stripe Billing: Subscription tiers (Starter $99/mo, Pro $299/mo, Scale $499/mo)
• Sentiment Analysis: Automated Reddit/HN scraping for model sentiment scores

Tech Stack

• Runtime: Cloudflare Workers
• Framework: Hono (lightweight, fast)
• Language: TypeScript
• Database: Neon Postgres (serverless)
• Payments: Stripe + x402 protocol
• Data Ingestion: Firecrawl API

Quick Start

Prerequisites

• Node.js 20+
• Cloudflare account
• Neon database
• Stripe account
• Firecrawl API key

Installation

npm install

Environment Setup

Copy .env.example to .env and configure:

cp .env.example .env

Required variables:

• NEON_DATABASE_URL - Neon Postgres connection string
• FIRECRAWL_API_KEY - Firecrawl API key
• STRIPE_SECRET_KEY - Stripe secret key
• STRIPE_STARTER_PRICE_ID - Stripe price ID for Starter tier
• STRIPE_PRO_MONTHLY_PRICE_ID - Stripe price ID for Pro tier
• STRIPE_SCALE_MONTHLY_PRICE_ID - Stripe price ID for Scale tier

Database Setup

# Apply schema to Neon
npx tsx scripts/setup-neon-db.ts

# Verify tables created
npx tsx scripts/verify-db.ts

Development

npm run dev

Deploy

npm run deploy

API Documentation

Authentication

All endpoints require an API key via header or query parameter:

X-API-Key: your-api-key
# or
?api_key=your-api-key

Endpoints

GET /llm-costs

Returns LLM pricing data.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/llm-costs

GET /model-benchmarks

Returns model benchmark results.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/model-benchmarks

GET /api-deprecations

Returns deprecated API versions.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/api-deprecations

GET/POST /quality-scores

Quality scores with optional sentiment refresh.

# Get scores
curl -H "X-API-Key: your-key" https://your-worker.workers.dev/v1/quality-scores

# Trigger sentiment refresh
curl -H "X-API-Key: your-key" "https://your-worker.workers.dev/v1/quality-scores?refresh=true"

POST /agent-spend

Log agent API spend with x402 micropayment support.

curl -X POST -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"agent-123","model":"gpt-4","tokens_used":1500,"cost":0.045,"payment_receipt":"x402-receipt"}' \
  https://your-worker.workers.dev/agent-spend

GET /agent-spend

Retrieve agent spend records.

curl -H "X-API-Key: your-key" "https://your-worker.workers.dev/agent-spend?agent_id=agent-123"

MCP Hub Submission

This server implements the Model Context Protocol for AI agent integration. Submit to MCP Hub with:

• Server Name: agentlayer-mcp-server
• Description: Real-time AI infrastructure data (costs, benchmarks, deprecations, quality scores, spend tracking)
• Transport: HTTP with API key auth
• Repository: https://github.com/[org]/agentlayer-mcp-server

Architecture

src/
├── index.ts                    # Main Hono app with all endpoints
├── routes/
│   └── v1-quality-scores.ts   # Quality scores route with sentiment refresh
└── scrapers/
    └── reddit-hn-sentiment.ts # Reddit/HN sentiment scraper via Firecrawl

CI/CD

GitHub Actions workflow (.github/workflows/deploy.yml):

• Runs on push to main
• Type checks with TypeScript
• Deploys to Cloudflare Workers

Required GitHub secrets:

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID
• NEON_DATABASE_URL
• FIRECRAWL_API_KEY
• STRIPE_SECRET_KEY
• STRIPE_STARTER_PRICE_ID
• STRIPE_PRO_MONTHLY_PRICE_ID
• STRIPE_SCALE_MONTHLY_PRICE_ID

License

MIT

Support

For issues and feature requests, please use the GitHub issue tracker.