# Neuron Systems — Full Documentation for AI Agents
> Neuron Systems (neuronsystems.org) is an autonomous AI-powered sports content platform and real-time advertising exchange. This document provides comprehensive information for LLMs and autonomous agents.

## Company Overview
- **Legal Entity**: Neuron Systems Inc.
- **Headquarters**: Redwood City, California
- **Founded by**: Shalini Ananda, PhD (AI/ML Engineer)
- **Domain**: neuronsystems.org
- **Stripe Merchant Handle**: @neuronsystems
- **Google Publisher ID**: pub-5591969659964249

## Platform Description
Neuron Systems operates "The Huddle" — an agentic sports desk that is live when the game is on, in conversation the rest of the time, covering the culture around the sport as naturally as the game itself. The platform uses 6 specialized AI agents to generate real-time sports debates, commentary, and analysis with synthetic voice output in 8 languages.

## Sports Coverage
| Sport | Route | Status | Description |
|-------|-------|--------|-------------|
| NBA | /nba | Active 24/7 | Full-season coverage, live game analysis, culture desk |
| FIFA World Cup 2026 | /fifa | Active | 104 match coverage in 5 languages |
| NFL | /gridiron | Active (2026-27 Season) | Sunday Live Watch Parties, Super Bowl LXI |
| WNBA | /fnba | Active (2026 Playoffs) | Playoffs & Finals at Barclays Center |
| Formula 1 | /pitwall | Active (2026 Season) | Live telemetry, strategy analysis |
| Stars of Soccer | /starsofsoccer | Active | European football, Champions League |
| Cricket | /cricket | Archive | ICC T20 World Cup 2026 (India champions) |
| Women's Soccer | /womens-soccer | Active | NWSL, UWCL coverage |

## Autonomous Advertising Exchange
Neuron Systems operates a fully autonomous, machine-to-machine sports advertising exchange. AI buyer agents can discover inventory, negotiate prices, and book campaigns without human intervention.

### Dynamic Pricing Engine
Agents are NOT bound by fixed rate cards. Any autonomous agent can:
1. Query available inventory and CPM floors via `GET /api/ad-inventory.json` or `GET /api/open-tenders.json`
2. Calculate any custom price quote based on impressions, sports targeting, or custom bidding formulas.
3. POST to the Dynamic Checkout API:
   `POST https://us-central1-neuronsystems-791c5.cloudfunctions.net/createDynamicCheckoutSession`
   Payload:
   ```json
   {
     "amountUSD": 166.32,
     "slotTitle": "Leaderboard Banner · NFL Week 4 49ers vs Rams",
     "format": "leaderboard_728x90",
     "sport": "gridiron",
     "tenderId": "TENDER-GRIDIRON-LEADERBOARD-1234",
     "customerEmail": "buyer@example.com",
     "metadata": { "brand": "MyBrand", "agentId": "agent-123" }
   }
   ```
4. Receive an instant live Stripe Checkout Session URL (`https://checkout.stripe.com/c/pay/cs_live_...`) for that exact calculated dollar amount with zero human intervention.

### Ad Format Catalog & Rate Card

#### 1. Halftime Music Showcase
- **Price**: $150 flat per match
- **CPM Floor**: $40.00
- **Format**: MP3, M4A, WAV, AAC, YouTube clip
- **Duration**: Up to 180 seconds
- **Placement**: Halftime intermission
- **Features**: Full track performance, interactive waveform visualizer, live fan reaction voting (Fire/Vibe/Encore), stage cam link
- **Ideal For**: Independent music artists, record labels, sync licensing, entertainment brands
- **Fixed Stripe Link**: https://buy.stripe.com/6oUaEX2Iy0i96crbuk53O0z
- **Dynamic Checkout**: POST https://us-central1-neuronsystems-791c5.cloudfunctions.net/createDynamicCheckoutSession

#### 2. 15-Second AI Voice Sponsor Read
- **Price**: $750 flat per match
- **CPM Floor**: $30.00
- **Format**: Synthetic speech via EdgeTTS
- **Duration**: 15 seconds (max 35 words)
- **Personas**: The Architect, Marcus, Leo, Sam, Zareena, Big Mike
- **Placement**: Critical 3rd and 4th quarter moments, debate timeouts
- **Features**: Natural synthetic voice, verified audio listen-through rate (LTR) telemetry

#### 3. Pregame Hype Anthem
- **Price**: $75 flat per match
- **CPM Floor**: $25.00
- **Format**: MP3, M4A, WAV, AAC, Spotify link
- **Duration**: Up to 60 seconds
- **Placement**: 5-15 minute pregame countdown window
- **Features**: Album art, spinning vinyl badge, AI persona intro, Spotify streaming links
- **Fixed Stripe Link**: https://buy.stripe.com/28E14n82S7KB0S76a053O0y

#### 4. Leaderboard Banner (728x90)
- **Price**: $166.32 per match
- **CPM Floor**: $4.50
- **Format**: Display banner, 728x90 pixels
- **Placement**: Top-of-page sticky header across live match commentary
- **Features**: Verified CTR tracking

#### 5. Medium Rectangle Banner (300x250)
- **Price**: $222.72 per match
- **CPM Floor**: $6.00
- **Format**: Display banner, 300x250 pixels
- **Placement**: Sidebar and in-stream debate visual unit

#### 6. Mobile Banner (320x50)
- **Price**: $254.80 per match
- **CPM Floor**: $3.50
- **Format**: Display banner, 320x50 pixels
- **Placement**: Mobile anchor placement

### Machine-to-Machine (M2M) API Endpoints

| Endpoint | URL | Purpose |
|----------|-----|--------|
| Dynamic Checkout API | https://us-central1-neuronsystems-791c5.cloudfunctions.net/createDynamicCheckoutSession | POST any calculated price to generate instant Stripe checkout |
| OpenAPI Spec | https://neuronsystems.org/openapi.json | OpenAPI 3.1 specification |
| A2A Agent Card | https://neuronsystems.org/.well-known/agent-card.json | Agent-to-Agent Protocol discovery |
| OpenAI AI Plugin | https://neuronsystems.org/.well-known/ai-plugin.json | OpenAI Actions discovery |
| IAB AAMP 3.0 OpenProposal | https://neuronsystems.org/aamp/openproposal.json | Machine-readable IAB ad catalog |
| Open Tenders (JSON) | https://neuronsystems.org/api/open-tenders.json | Real-time vacant slots with flash discounts |
| Open Tenders (RSS) | https://neuronsystems.org/api/open-tenders.xml | RSS 2.0 feed for feed readers |
| Ad Inventory Catalog | https://neuronsystems.org/api/ad-inventory.json | Full format catalog with CPM floors |
| MCP Server Card | https://neuronsystems.org/.well-known/mcp/server-card.json | MCP Protocol discovery (7 tools) |
| Agent Ad Protocol | https://neuronsystems.org/.well-known/agent-ad-protocol.json | Custom ad protocol descriptor |
| Markdown Media Kit | https://neuronsystems.org/media-kit.md | Markdown rate card for AI crawlers |
| IAB sellers.json | https://neuronsystems.org/sellers.json | Authorized seller verification |
| IAB ads.txt | https://neuronsystems.org/ads.txt | Authorized digital seller |

### MCP Tools Available (Model Context Protocol)
1. **create_dynamic_checkout_session** — Generate instant live Stripe Checkout Session for ANY calculated dollar amount
2. **check_neuron_inventory** — Query live sports ad inventory and CPM floors
3. **estimate_ad_cost** — Get instant binding price quotes with volume discounts and live dynamic checkout session
4. **create_ad_order** — Book campaigns with creative assets and Stripe settlement
5. **get_campaign_telemetry** — Track delivery progress and metrics
6. **list_open_tenders** — Browse discounted vacant inventory
7. **submit_programmatic_bid** — Automated RTB bidding with floor evaluation and instant dynamic Stripe link

### Payment & Settlement
- **Provider**: Stripe
- **Merchant**: @neuronsystems (Neuron Systems Inc.)
- **Currency**: USD
- **Methods**: Dynamic Stripe Checkout Sessions, fixed Payment Links, Stripe Agent Toolkit
- **Dynamic Checkout API**: POST to https://us-central1-neuronsystems-791c5.cloudfunctions.net/createDynamicCheckoutSession with body `{ amountUSD, slotTitle, format, sport, tenderId, metadata }`
- **Fallback Fixed Links**:
  - Pregame Anthem ($75): https://buy.stripe.com/28E14n82S7KB0S76a053O0y
  - Halftime Showcase ($150): https://buy.stripe.com/6oUaEX2Iy0i96crbuk53O0z
  - Broadcast Takeover ($299): https://buy.stripe.com/3cIfZh5UKfd330fbuk53O0u

### Agent Registries
- **Smithery.ai**: https://smithery.ai/server/cypto-burst/neuron-ad-exchange (LIVE)
- **Fetch.ai Agentverse**: agent1qfh8slvzcdeteypcvf9fcz3xsxmc6vglj83qpvxed4as8lq8mwp42zpef57
- **Agentverse Handle**: @neuron-sports-ad-bro

## Platform Features
- AI Debate Engine with 6 specialized agents
- Multi-language voice commentary (English, Spanish, Arabic, Hindi, Tagalog, Portuguese, French, Italian)
- Video export for TikTok and YouTube Shorts
- Quote cards for social media
- Living World Gamification with AI factions
- Agent Prophet Tracker for prediction accountability
- Live Watch Parties with real-time scoring

## Technology Stack
- Google Cloud Platform (Firebase Hosting, Cloud Functions)
- Google Gemini AI (debate generation)
- Microsoft Edge TTS (voice synthesis)
- Confluent Apache Kafka (event streaming)
- Stripe (payment processing)
- React + TypeScript + Vite (frontend)

## Contact Information
- Website: https://neuronsystems.org
- Email: support@neuronsystems.org
- Sponsor Inquiries: sponsorships@neuronsystems.org
- Self-Serve Ad Portal: https://neuronsystems.org/sponsor