net.sprtx/sprtx-mcp

Install

Config snippet generator goes here (5 client tabs)

README

# SPRTX MCP Server

Model Context Protocol server for the SPRTX Network, sports tokenization and new global sports economy. Pure PHP. Zero dependencies. Streamable HTTP transport.

**1,435 tokens · 98 sports · 9 global regions · $127.74M market cap · GENESIS phase · Updating Weekly**

## What is this?

An [MCP](https://modelcontextprotocol.io) server that lets AI agents discover, browse, and trade structured sports tokens on the SPRTX network. Agents connect via JSON-RPC 2.0 over Streamable HTTP — no SDK, no browser, no UI. Protocol-native access to the entire sports token registry.

SPRTX tokenizes the global sports hierarchy: federations → leagues → teams → athletes → venues. Every asset has a price, a position in the hierarchy, and demand signal. The MCP server is the agent-native entry point.

## Connect

```
Endpoint: https://mcp.sprtx.net
Transport: Streamable HTTP
Protocol: 2025-03-26
```

Auto-discovery:
```
https://sprtx.net/.well-known/mcp/server.json
```

## Capabilities

### Resources (read-only, no auth)

| URI | Description |
|-----|-------------|
| `sprtx://registry/tokens` | All 1,435 tokens with pricing and hierarchy |
| `sprtx://registry/sports` | 98 sport categories + index tokens |
| `sprtx://registry/stats` | Network summary: market cap, volume, phase, holders |
| `sprtx://registry/organizations` | Federations, leagues, teams, venues |
| `sprtx://registry/venues` | Venues with tenant team mappings |

### Tools

| Tool | Description | Auth |
|------|-------------|------|
| `search_tokens` | Search by keyword, type, sport, price range, parent | Free |
| `get_token` | Full token detail with hierarchy and demand | Free |
| `get_hierarchy` | Token family tree: ancestors above, children below | Free |
| `get_token_price` | Current price, market cap, volume data | Free |
| `get_waitlist` | Demand signal: waitlist signups, endorsements | Free |
| `get_network_stats` | Network summary with phase indicator | Free |
| `request_pher_key` | Initiate PHER key acquisition ($55) | Free |

Trading tools (buy, sell, transfer) require an active [PHER key](https://sprtx.net/key). Coming in v1.1.

### Prompts

| Prompt | What it does |
|--------|-------------|
| `explore-sprtx-market` | Browse the full token market, find opportunities |
| `evaluate-token` | Analyze a specific token: price, hierarchy, demand |
| `acquire-pher-key` | Start the key acquisition flow for trading access |

## Quick Start

Initialize a session:

```bash
curl -s -X POST https://mcp.sprtx.net \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -D - \
  -d '{
    "jsonrpc": "2.0",
    "id": "init-1",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "clientInfo": {"name": "my-agent", "version": "1.0.0"}
    }
  }'
```

Use the returned `Mcp-Session-Id` header for subsequent requests:

```bash
curl -s -X POST https://mcp.sprtx.net \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": "search-1",
    "method": "tools/call",
    "params": {
      "name": "search_tokens",
      "arguments": {"q": "giants", "type": "TEAM"}
    }
  }'
```

## Architecture

```
Agent → mcp.sprtx.net (mcp.php)
            ↓ JSON-RPC 2.0
        api.php (9 endpoints)
            ↓ prepared statements
        MariaDB (blockchain_tokens, blockchain_agents, etc.)
```

Pure PHP. No Node. No npm. No SDK. Single endpoint, Streamable HTTP transport, session management via filesystem. Runs on any shared hosting with PHP 7.2+.

## Token Hierarchy

```
PLATFORM (SPRTX)
  └── SPORT (SOCCER, AMERICANFOOTBALL, BASKETBALL, ...)
        └── LEAGUE (NFL, EPL, NBA, MLB, ...)
              └── TEAM (NYGIANTS, SFGIANTS, LAKINGS, ...)
                    └── ATHLETE (coming)
  └── GEOLOCATION (US, US-FL, US-CA, ...)
  └── VENUE (METLIFE, WEMBLEY, ...)
  └── ORDER (2026, W-SPRTX, A-SPRTX, P-SPRTX, ...)
```

98 sports. 580 teams. 298 venues. 249 geolocations. 112 leagues. Loading ongoing.

## PHER Keys

Agents browse for free. Trading requires a [PHER key](https://sprtx.net/key) ($55) — a hardware-backed cryptographic identity on the SPRTX network. PHER (Permissible Human Entry Request) is the authentication layer for the Internet of Sports Protocol.

Agent-native key provisioning is active. First movers acquire positions before public trading opens.

## Network Phase

SPRTX is in **GENESIS** — token registry live, zero transactions on-chain. Phase auto-progresses:

| Phase | Transactions | Status |
|-------|-------------|--------|
| GENESIS | 0 | Current — early positioning window |
| LAUNCH | 1-100 | First trades on-chain |
| EARLY | 101-10,000 | Active trading |
| ACTIVE | 10,000+ | Mature network |

## Loading Status

SPRTX is tokenizing the entire global sports economy — 98 sports across 9 global regions and all stakeholders.
Token hierarchies (federations and leagues, teams, athletes, venues) are loading continuously as the
network expands. Ne