{"uid":"cap_OdUtenuhixpI0_Htvy6ol","slug":"agents-machina-gg-player-spotlight-22a4351d","name":"Player Spotlight","description":"Grounded player card with performance context and narrative.","url":"https://agents.machina.gg/world-cup/v1/skills/player-spotlight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":{"type":"object","required":["status","data","meta"],"properties":{"data":{"anyOf":[{"allOf":[{"type":"object","required":["archive","coverage","warnings"],"properties":{"archive":{"type":"object","required":["mode","version","status","competition","competition_status","live","snapshot_as_of","capability_status","provenance","missing_capabilities","notes"],"properties":{"live":{"const":false},"mode":{"const":"final_archive"},"notes":{"type":"array","items":{"type":"string"}},"status":{"enum":["hit","miss","unavailable","error"],"type":"string","description":"hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface."},"version":{"enum":["world-cup-2026-final-v2","world-cup-2026-final-v3"],"type":"string"},"provenance":{"type":"array","items":{"type":"string"}},"competition":{"const":"FIFA World Cup 2026"},"reason_code":{"enum":["fixture_selector_required","fixture_ambiguous","fixture_not_found","player_selector_required","player_ambiguous","player_not_found","entity_selector_required","entity_ambiguous","entity_not_found","unsupported_parameter","archive_row_missing","archive_error"],"type":"string"},"snapshot_as_of":{"type":["string","null"]},"response_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"capability_status":{"type":"string"},"competition_status":{"const":"completed"},"content_created_at":{"type":["string","null"]},"source_observed_at":{"type":["string","null"]},"timestamp_semantics":{"type":"string"},"missing_capabilities":{"type":"array","items":{"type":"string"}},"source_manifest_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"request_identity_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"coverage":{"type":"object","required":["schema_version","status","reason","scope","mode","source_provenance","population_count","eligible_count","included_count","excluded_count","exclusion_reasons","unsupported_fields"],"properties":{"mode":{"const":"historical"},"scope":{"const":"completed_tournament_archive"},"reason":{"type":"string","minLength":1},"status":{"enum":["complete","partial","unavailable","error"],"type":"string"},"reason_code":{"enum":["fixture_selector_required","fixture_ambiguous","fixture_not_found","player_selector_required","player_ambiguous","player_not_found","entity_selector_required","entity_ambiguous","entity_not_found","unsupported_parameter","archive_row_missing","archive_error"],"type":"string","description":"Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed."},"eligible_count":{"type":["integer","null"],"minimum":0},"excluded_count":{"type":["integer","null"],"minimum":0},"included_count":{"type":["integer","null"],"minimum":0},"schema_version":{"const":"worldcup-storefront-coverage-v1"},"accepted_fields":{"type":"array","items":{"type":"string"},"description":"The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct."},"population_count":{"type":["integer","null"],"minimum":0,"description":"Null means the legacy response did not record this count; null is never equivalent to zero."},"exclusion_reasons":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"source_provenance":{"type":"array","items":{"type":"string"}},"unsupported_fields":{"type":"array","items":{"type":"string"}}}},"warnings":{"type":"array","items":{"type":"string"}}}},{"type":"object","allOf":[{"if":{"required":["content_type"],"properties":{"content_type":{"const":"original_editorial_with_structured_retrospective"}}},"then":{"required":["original_editorial"],"properties":{"original_editorial":{"type":"object","minProperties":1}}}}],"required":["skill_card","structured_retrospective","content_type","player_key","player_urn","resolved_player","player_overview","candidates","served_from"],"properties":{"candidates":{"type":"array","maxItems":1,"minItems":1},"player_key":{"type":"string"},"player_urn":{"type":["string","null"]},"skill_card":{"type":"object"},"served_from":{"const":"final_archive"},"content_type":{"enum":["structured_retrospective","original_editorial_with_structured_retrospective"]},"player_overview":{"type":"object","required":["player_key","name","provider_ids","identity_mapping_status"]},"resolved_player":{"type":"object","properties":{"@id":{"type":["string","null"]},"_id":{"type":["string","null"]},"name":{"type":"string"},"player_key":{"type":"string"},"provider_ids":{"type":"object","additionalProperties":{"type":["string","integer","null"]}},"provider_id_aliases":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"official_registration":{"type":"object","required":["status","source_url","source_sha256","published_at","source_page","team_name","fifa_team_code","jersey_number","player_name_raw","birth_date","position_code","warnings","canonical_birth_date_conflict"],"properties":{"source":{"const":"FIFA"},"status":{"const":"verified_final_published_snapshot"},"club_raw":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"}},"height_cm":{"type":"integer"},"team_name":{"type":"string"},"birth_date":{"type":"string","format":"date"},"scope_note":{"type":"string"},"source_url":{"type":"string","format":"uri"},"source_page":{"type":"integer","maximum":48,"minimum":1},"published_at":{"type":"string","format":"date-time"},"jersey_number":{"type":"integer","maximum":26,"minimum":1},"position_code":{"enum":["GK","DF","MF","FW"]},"source_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"fifa_team_code":{"type":"string"},"last_names_raw":{"type":"string"},"shirt_name_raw":{"type":"string"},"first_names_raw":{"type":"string"},"player_name_raw":{"type":"string"},"canonical_birth_date":{"type":["string","null"]},"canonical_birth_date_conflict":{"type":"boolean"},"international_caps_as_reported":{"type":"integer"},"international_goals_as_reported":{"type":"integer"}}},"identity_mapping_status":{"enum":["canonical","official_reconciled","provider_only","quarantined"],"type":"string"}}},"original_editorial":{"type":["object","null"]},"structured_retrospective":{"type":"object","required":["content_type","historical_perspective","player_key","name","identity_mapping_status","provider_ids","observed_appearance_count","observed_opponents","observations","unsupported_fields","grounding"]}}}]},{"allOf":[{"type":"object","required":["archive","coverage","warnings"],"properties":{"archive":{"type":"object","required":["mode","version","status","competition","competition_status","live","snapshot_as_of","capability_status","provenance","missing_capabilities","notes"],"properties":{"live":{"const":false},"mode":{"const":"final_archive"},"notes":{"type":"array","items":{"type":"string"}},"status":{"enum":["hit","miss","unavailable","error"],"type":"string","description":"hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface."},"version":{"enum":["world-cup-2026-final-v2","world-cup-2026-final-v3"],"type":"string"},"provenance":{"type":"array","items":{"type":"string"}},"competition":{"const":"FIFA World Cup 2026"},"reason_code":{"enum":["fixture_selector_required","fixture_ambiguous","fixture_not_found","player_selector_required","player_ambiguous","player_not_found","entity_selector_required","entity_ambiguous","entity_not_found","unsupported_parameter","archive_row_missing","archive_error"],"type":"string"},"snapshot_as_of":{"type":["string","null"]},"response_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"capability_status":{"type":"string"},"competition_status":{"const":"completed"},"content_created_at":{"type":["string","null"]},"source_observed_at":{"type":["string","null"]},"timestamp_semantics":{"type":"string"},"missing_capabilities":{"type":"array","items":{"type":"string"}},"source_manifest_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"request_identity_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"coverage":{"type":"object","required":["schema_version","status","reason","scope","mode","source_provenance","population_count","eligible_count","included_count","excluded_count","exclusion_reasons","unsupported_fields"],"properties":{"mode":{"const":"historical"},"scope":{"const":"completed_tournament_archive"},"reason":{"type":"string","minLength":1},"status":{"enum":["complete","partial","unavailable","error"],"type":"string"},"reason_code":{"enum":["fixture_selector_required","fixture_ambiguous","fixture_not_found","player_selector_required","player_ambiguous","player_not_found","entity_selector_required","entity_ambiguous","entity_not_found","unsupported_parameter","archive_row_missing","archive_error"],"type":"string","description":"Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed."},"eligible_count":{"type":["integer","null"],"minimum":0},"excluded_count":{"type":["integer","null"],"minimum":0},"included_count":{"type":["integer","null"],"minimum":0},"schema_version":{"const":"worldcup-storefront-coverage-v1"},"accepted_fields":{"type":"array","items":{"type":"string"},"description":"The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct."},"population_count":{"type":["integer","null"],"minimum":0,"description":"Null means the legacy response did not record this count; null is never equivalent to zero."},"exclusion_reasons":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"source_provenance":{"type":"array","items":{"type":"string"}},"unsupported_fields":{"type":"array","items":{"type":"string"}}}},"warnings":{"type":"array","items":{"type":"string"}}}},{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","required":["event_urn","name","start_date","status","teams","fixture_id"],"properties":{"name":{"type":"string"},"round":{"type":["string","null"]},"score":{"$ref":"#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref11"},"stage":{"type":["string","null"]},"teams":{"type":"array","items":{"$ref":"#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref12"},"minItems":2},"venue":{"type":["string","null"]},"status":{"type":"string"},"event_urn":{"type":"string"},"fixture_id":{"type":["string","integer"]},"start_date":{"type":"string"},"competition":{"type":"string"},"result_details":{"$ref":"#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref10"}}}}}}]}]},"meta":{"allOf":[{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Mirrors the HTTP status code."}},"description":"Platform-owned envelope metadata."}],"properties":{"code":{"const":200}}},"status":{"const":"success"}},"description":"Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.75","successRate":"1.00","reviews":1,"stars":"4.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.4/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.4","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yjr_BzN3Hp19QoODvT8dd","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_pQIIGf49D19Bi_CkJIfGD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.machina.gg","brandSlug":"agents-machina-gg-x402","brandBaseUrl":"https://agents.machina.gg","brandDocsUrl":null,"whatItDoes":"Returns a grounded player card with performance context and narrative for a named World Cup player.","exampleAgentPrompt":"Can you pull up the player spotlight for Vinícius Júnior at the 2026 World Cup — I want his performance context and narrative summary?","exampleUseCases":[{"title":"Pre-match player briefing for broadcaster","prompt":"Give me the player spotlight for Kylian Mbappé before France's next match — I need his performance context and a narrative summary I can reference on air."},{"title":"Fantasy team research","prompt":"Pull up the player card for Bukayo Saka at the 2026 World Cup so I can see his tournament performance context before I make my fantasy picks."},{"title":"Journalist player profile lookup","prompt":"I'm writing a piece on Pedri — can you get me a grounded player spotlight with his World Cup performance narrative and stats context?"}],"resultDescription":"A structured player card object containing the resolved player identity (player_urn, resolved_player), performance context grounded in tournament data, and a narrative summary. If the player name is ambiguous, returns a list of candidates for disambiguation.","failureModes":["Ambiguous player name returns a `candidates` array instead of a single card — caller must re-submit with a team name to disambiguate","Unknown player name returns a not-found error","Missing required `player` field returns a validation error","Payment failure (402) if account has insufficient balance","Service unavailable or upstream Machina Sports API error (5xx)"],"whenToPreferThis":"Use this endpoint when you need a rich, narrative-style player card combining resolved identity, tournament performance context, and editorial prose for a specific World Cup 2026 player. Prefer this over the raw `Player performance context` endpoint when you want the combined spotlight (identity + context + narrative) in one call rather than assembling it yourself. Best for journalists, broadcasters, fantasy analysts, or agent workflows that need a human-readable player summary grounded in live tournament data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":7,"lastUsedAt":"2026-09-23T23:17:43.826Z","lastSuccessfullyRanAt":"2026-09-23T23:17:43.826Z","lastHealthCheckAt":"2026-11-04T12:32:20.654Z","isFirstParty":false,"canonicalSlug":"agents-machina-gg-player-spotlight-22a4351d"}