API & Agent Documentation
Machine-readable interfaces for AI agents and developers. Retrieve verified player ratings, matches, courts, and club parameters with no API key required.
Overview
Pickle Gravity exposes REST JSON endpoints and a standard Model Context Protocol (MCP) card. Factual players, matches, courts, and clubs data carry canonical URLs to protect against LLM hallucinations.
- Base URL:
https://picklegravity.com - Data format: JSON, Markdown (format=md)
- Authentication: None (Public Read-only)
Quick start
- Fetch the registry sitemap of endpoint mappings:/agent-readiness.json
- Query records via the search endpoint (q=keyword):
curl "https://picklegravity.com/api/knowledge?q=Philip&lang=en"
- Retrieve an individual record in LLM-friendly Markdown:
curl "https://picklegravity.com/api/knowledge/player-DU49A8F?format=md"
REST endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/content | General metadata, FAQ index, and sister sites |
| GET | /api/knowledge | Full index search or filter with ?q= |
| GET | /api/knowledge/[id] | Get details of specified asset in JSON format |
| GET | /api/knowledge/[id]?format=md | Export record in high-density Markdown summary |
| GET | /api/knowledge/mcp | Retrieve Model Context Protocol tools description |
MCP Tool Integration
AI agents can dynamically discover and register our tools. The MCP server card details these operations:
search_knowledge
Performs search queries by text across all players, courts, matches, and clubs.
get_article
Fetches a specific record by its prefixed unique ID in JSON or Markdown format.
Rate limits
Public endpoints are rate-limited to approximately 5 requests per second. For bulk data extraction, please space calls out and avoid high peak hours.