getcompetitive

Overview Schema Source Related Servers Discussions Admin

Get item data

get_item

Read-onlyIdempotent

Retrieve a held item's full effect data, including category flags, Z-move, Natural Gift, Fling, and stat boosts. Confirm what an item does before recommending it in a competitive Pokémon team.

Instructions

Get one held item's data: effect text, category flags (Berry, Choice, Mega Stone, …), Z-move, Natural Gift, Fling, and flat stat boosts. Use it to confirm what an item actually does before recommending it; get_set returns the item a curated meta set runs. Accepts item names case-insensitively; unknown items return an isError with near matches. Read-only and offline.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`item`	Yes	Item name, e.g. "Choice Band", "Assault Vest", "Leftovers".

Output Schema

TableJSON Schema

Name	Required	Description
`gen`	Yes	Generation the item was introduced in.
`num`	Yes	Item number in the dataset; 0 for items that have none.
`desc`	Yes	Full effect description.
`name`	Yes	Item name, e.g. "Choice Band".
`fling`	No	Fling data, present only for items that can be flung.
`isGem`	No	true when the item is a one-use type Gem that boosts a matching move; absent otherwise.
`zMove`	No	For Z-Crystals: the Z-Move it unlocks, or true for crystals whose move depends on the held move; absent when the item is not a Z-Crystal.
`boosts`	No	Flat stat stages the item grants while held, keyed by stat id, e.g. {"atk": 2} for Choice Band; absent for items that do not change stats directly.
`isBerry`	No	true when the item is a Berry (held and eaten on a trigger); absent otherwise.
`isChoice`	No	true when the item is a Choice item that locks the holder into one move; absent otherwise.
`itemUser`	No	Species that can use the item where it is restricted to them; absent when any species can hold it.
`megaStone`	No	Mega Stone holders: species name to the Mega forme it unlocks, e.g. {"Garchomp": "Garchomp-Mega"}; absent when the item is not a Mega Stone.
`shortDesc`	Yes	One-line effect summary.
`isPokeball`	No	true when the item is a Poké Ball used for catching; absent otherwise.
`forcedForme`	No	Forme this item forces on its holder, e.g. "Dialga-Origin" for Adamant Crystal; absent when the item changes no forme.
`naturalGift`	No	Natural Gift data, present only for Berries (the items Natural Gift can consume).
`isNonstandard`	Yes	"Past", "Future", "Unobtainable", or "CAP" when the item is not available in the current games; null when it is standard.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv3.2.0Sep 18, 2026

removedInput schema / properties / generation

Removed value: -{
-  "default": 9,
-  "description": "Generation whose data to use, 1-9 (default 9). Earlier generations omit moves, items, abilities, and forms that did not exist yet.",
-  "maximum": 9,
-  "minimum": 1,
-  "type": "integer"
-}

Changed3 schema fields changedv1.1.1Sep 15, 2026

addedInput schema / properties / generation / description

Added value: +"Generation whose data to use, 1-9 (default 9). Earlier generations omit moves, items, abilities, and forms that did not exist yet."

addedInput schema / properties / item / description

Added value: +"Item name, e.g. \"Choice Band\", \"Assault Vest\", \"Leftovers\"."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "boosts": {
+      "additionalProperties": {
+        "type": "number"
+      },
+      "description": "Flat stat stages the item grants while held, keyed by stat id, e.g. {\"atk\": 2} for Choice Band; absent for items that do not change stats directly.",
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "desc": {
+      "description": "Full effect description.",
+      "type": "string"
+    },
+    "fling": {
+      "additionalProperties": false,
+      "description": "Fling data, present only for items that can be flung.",
+      "properties": {
+        "basePower": {
+          "description": "Base power Fling gains from this item.",
+          "type": "number"
+        },
+        "status": {
+          "description": "Major status Fling inflicts on the target, when the item does (e.g. \"par\").",
+          "type": "string"
+        },
+        "volatileStatus": {
+          "description": "Volatile status Fling inflicts on the target, when the item does (e.g. \"flinch\").",
+          "type": "string"
+        }
+      },
+      "required": [
+        "basePower"
+      ],
+      "type": "object"
+    },
+    "forcedForme": {
+      "description": "Forme this item forces on its holder, e.g. \"Dialga-Origin\" for Adamant Crystal; absent when the item changes no forme.",
+      "type": "string"
+    },
+    "gen": {
+      "description": "Generation the item was introduced in.",
+      "type": "number"
+    },
+    "isBerry": {
+      "description": "true when the item is a Berry (held and eaten on a trigger); absent otherwise.",
+      "type": "boolean"
+    },
+    "isChoice": {
+      "description": "true when the item is a Choice item that locks the holder into one move; absent otherwise.",
+      "type": "boolean"
+    },
+    "isGem": {
+      "description": "true when the item is a one-use type Gem that boosts a matching move; absent otherwise.",
+      "type": "boolean"
+    },
+    "isNonstandard": {
+      "description": "\"Past\", \"Future\", \"Unobtainable\", or \"CAP\" when the item is not available in the current games; null when it is standard.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "isPokeball": {
+      "description": "true when the item is a Poké Ball used for catching; absent otherwise.",
+      "type": "boolean"
+    },
+    "itemUser": {
+      "description": "Species that can use the item where it is restricted to them; absent when any species can hold it.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "megaStone": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Mega Stone holders: species name to the Mega forme it unlocks, e.g. {\"Garchomp\": \"Garchomp-Mega\"}; absent when the item is not a Mega Stone.",
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "name": {
+      "description": "Item name, e.g. \"Choice Band\".",
+      "type": "string"
+    },
+    "naturalGift": {
+      "additionalProperties": false,
+      "description": "Natural Gift data, present only for Berries (the items Natural Gift can consume).",
+      "properties": {
+        "basePower": {
+          "description": "Base power Natural Gift gains from this item.",
+          "type": "number"
+        },
+        "type": {
+          "description": "Type Natural Gift becomes with this item, e.g. \"Fire\".",
+          "type": "string"
+        }
+      },
+      "required": [
+        "basePower",
+        "type"
+      ],
+      "type": "object"
+    },
+    "num": {
+      "description": "Item number in the dataset; 0 for items that have none.",
+      "type": "number"
+    },
+    "shortDesc": {
+      "description": "One-line effect summary.",
+      "type": "string"
+    },
+    "zMove": {
+      "description": "For Z-Crystals: the Z-Move it unlocks, or true for crystals whose move depends on the held move; absent when the item is not a Z-Crystal.",
+      "type": [
+        "string",
+        "boolean"
+      ]
+    }
+  },
+  "required": [
+    "name",
+    "num",
+    "gen",
+    "shortDesc",
+    "desc",
+    "isNonstandard"
+  ],
+  "type": "object"
+}

First observedv0.1.0Sep 14, 2026

TDQS

A4.9/5.0

Behavior5/5

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

Annotations already mark this as read-only, idempotent, and non-destructive, and the description reinforces this with 'Read-only and offline.' It adds valuable behavioral details beyond the annotations: case-insensitive item matching, unknown items returning an isError with near matches, and the item data categories returned. No contradiction with annotations.

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

Conciseness5/5

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

Three concise sentences each earn their place: the first defines scope and outputs, the second gives usage guidance and the sibling contrast, the third covers input behavior and operational traits. No filler or repetition of the schema.

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

Completeness5/5

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

Given only one parameter, a rich output schema, and annotations covering safety and idempotency, the description fully covers what an agent needs: purpose, usage context, input behavior, error handling, and read-only/offline nature. Nothing material is missing.

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

Parameters4/5

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

The schema already documents the single 'item' parameter with examples and 100% coverage, so the baseline is strong. The description additionally clarifies case-insensitivity and the error behavior for unknown items, which enhances parameter understanding beyond the schema.

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

Purpose5/5

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

The description states a specific action and resource: 'Get one held item's data' and enumerates the exact contents (effect text, category flags, Z-move, Natural Gift, Fling, stat boosts). It also distinguishes itself from the sibling get_set, which returns the item on a curated meta set, so an agent can clearly tell them apart.

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

Usage Guidelines5/5

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

Explicitly says to use it 'to confirm what an item actually does before recommending it' and names the alternative get_set as the tool that returns the item a set runs. This gives an agent a concrete selection rule with an exclusion and a sibling comparison.

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