Skip to main content
Glama

cricbuzz_auction_upcoming

Read-only

Fetches one page of unauctioned players with validated Country, Role, Cap, Sort, currency and page selections. Discover edition values via cricbuzz_auction_seasons and cricbuzz_auction_upcoming_options; country_ids is comma-separated.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "tournament": "<tournament>",
      "year": "<year>",
      "currency": "<currency>"
    },
    "name": "cricbuzz_auction_upcoming"
  }
}

Input Schema

NameRequiredDescriptionDefault
capNoExact Cap option value from auction/upcoming/options; values: Capped, Uncapped
pageNoOne-based page number; defaults to 1
roleNoExact Role option value from auction/upcoming/options; SA20 2027 labels: All, Batter, Bowler, All Rounder, WK Batter
sortNoSort label from auction/upcoming/options: Base Price: High to Low, Base Price: Low to High
yearYesEdition from cricbuzz/auction/seasons: IPL 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026; WPL 2023, 2024, 2025, 2026, 2027; SA20 2027; HUNM 2026; HUNW 2026
currencyYesCurrency accepted by the selected edition: INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR
tournamentYesTournament identifier from cricbuzz/auction/seasons: ipl, wpl, sa20, hunm, hunw
country_idsNoComma-separated exact Country option values from auction/upcoming/options; SA20 2027 labels: Afghanistan, Australia, Bangladesh, Canada, England, Hong Kong China, India, Ireland, Italy, Jersey, Kenya, Namibia, Nepal, Netherlands, New Zealand, Pakistan, Scotland, Singapore, South Africa, Sri Lanka, Thailand, United Arab Emirates, United States of America, West Indies, Zimbabwe

Output Schema

NameRequiredDescriptionDefault
dataYesThe tool result payload (shape varies per tool; see each tool's docs resource).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and openWorldHint, so safety is covered. The description usefully adds that results are paginated ('one page') and that filter values must be validated against an options endpoint, but it does not say how to detect more pages or what happens on an invalid filter value.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the operation and scope, followed by the prerequisite discovery step. No filler; the only slight redundancy is repeating the comma-separated country_ids note.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an eight-parameter, three-required filtered listing tool with an output schema and safe-read annotations, the description covers scope, pagination, and the discovery dependency. Remaining gaps (page exhaustion, invalid-value behavior) are minor given the schema and output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all eight parameters are already documented with option sources and value lists. The description's only added detail, 'country_ids is comma-separated', is already stated in the schema, so it adds no net value beyond the structured fields.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Fetches one page of unauctioned players', which scopes it apart from live/results auction siblings. It does not name the distinguished siblings explicitly, so the differentiation is implied by 'unauctioned' rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear prerequisite workflow: discover edition values via cricbuzz_auction_seasons and cricbuzz_auction_upcoming_options before calling. It does not say when to prefer this over cricbuzz_auction_live or cricbuzz_auction_results, so exclusions are absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.