{"uid":"cap_7C1bCnPEih458G8fntbOs","slug":"agentstools-sports-scores-48b5366e","name":"AgentsTools Sports Scores","description":"Live and recent game scores for a major sports league, normalized to one cited JSON. Give a league such as mlb, nhl, nfl, nba or epl and get each game with both teams, the score, the game state, the period or inning and the start time. Sourced from official league APIs and ESPN, each record tagged with its source.","url":"https://api.agentstools.dev/sports/scores","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["league"],"properties":{"date":{"type":"string","description":"Optional day filter as an ISO date such as 2025-10-01. Omit for live and current games."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Max records to return, default 50"},"league":{"enum":["mlb","nhl","nfl","nba","epl"],"type":"string","description":"League key. One of the supported major leagues."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o1CXpLPhTnPRBw9EfkyI7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live and recent game scores for MLB, NHL, NFL, NBA, or EPL, including both teams, score, game state, period/inning, and start time, sourced from official league APIs and ESPN.","exampleAgentPrompt":"What are the live NBA scores right now? Show me all games with current score, period, and game state.","exampleUseCases":null,"resultDescription":"A normalized JSON array of game records, each containing both team names, current score, game state (e.g. live, final, scheduled), the current period or inning, the game start time, and a source tag indicating whether data came from the official league API or ESPN.","failureModes":["Unsupported league key returns a validation error","Invalid ISO date format returns a 400 bad request","No games available for the given date returns an empty result set","Network timeout or upstream API outage from league or ESPN may cause 500 errors","limit parameter out of range (below 1 or above 100) returns a validation error"],"whenToPreferThis":"Use this endpoint when you need normalized, multi-source sports scores across MLB, NHL, NFL, NBA, or EPL in a single call. Prefer it over building your own scraper or calling multiple league APIs separately — it handles source normalization and tagging automatically. Best for real-time game tracking, score monitoring, or surfacing recent results to a user on demand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T08:20:15.700Z","isFirstParty":false}