{"schemaVersion":"2025-06-18","serverInfo":{"name":"viralref-public-api","title":"ViralRef Public API","version":"1.0.0","description":"Read-only Model Context Protocol server for ViralRef referral data: organization profile, referral programs, and affiliates.","documentation":"https://viralref.com/docs/api-reference","homepage":"https://viralref.com/developers"},"transport":{"type":"streamable-http","url":"https://api.viralref.com/mcp","protocolVersion":"2025-06-18","supportedProtocolVersions":["2025-06-18","2025-03-26","2024-11-05"]},"capabilities":{"tools":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false}},"authentication":{"required":false,"requiredFor":["tools/call"],"methods":[{"type":"apiKey","in":"header","name":"X-API-Key","instructions":"Create an API key at https://app.viralref.com under Settings > Organization > Developers."},{"type":"oauth2","flow":"client_credentials","tokenUrl":"https://api.viralref.com/oauth/token","metadata":"https://api.viralref.com/.well-known/oauth-authorization-server","protectedResourceMetadata":"https://api.viralref.com/.well-known/oauth-protected-resource"}]},"tools":[{"name":"get_organization","title":"Get organization","description":"Returns the ViralRef organization the API key belongs to: display name, address, phone, email, and website. Takes no arguments."},{"name":"list_programs","title":"List referral programs","description":"Lists referral programs for this organization, newest first, with status (DRAFT, LIVE, PAUSED), commission type and value, attribution scope, and reward mode."},{"name":"list_affiliates","title":"List affiliates","description":"Lists affiliates (referrers) for this organization, newest first, with role and status. Contact details are never returned."}],"resources":[{"uri":"viralref://api/openapi.json","name":"openapi","title":"ViralRef OpenAPI 3.0 document","mimeType":"application/json"},{"uri":"viralref://api/reference.md","name":"api-reference","title":"ViralRef API reference","mimeType":"text/markdown"},{"uri":"viralref://api/errors.md","name":"error-catalog","title":"ViralRef API error catalog","mimeType":"text/markdown"},{"uri":"viralref://api/scopes.md","name":"scopes","title":"ViralRef API scopes","mimeType":"text/markdown"},{"uri":"viralref://product/overview.md","name":"product-overview","title":"ViralRef product overview","mimeType":"text/markdown"}],"openapi":"https://api.viralref.com/openapi.json"}