io.github.thehesiod/costco
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| check_auth_statusA | Check if authenticated with Costco. Shows token status and expiry. Args: account: Account name (optional, uses default if empty). Use list_accounts to see all. |
| save_refresh_tokenA | Save a refresh token obtained from a browser login session. Use this to add a new account or update an existing one. The refresh token is valid for 90 days. Args: refresh_token: The OAuth2 refresh token from Costco's Azure AD B2C account: Account name (e.g. "personal", "spouse"). Creates the account if new. If empty, uses default account. |
| list_warehouse_receiptsA | List in-warehouse purchase receipts for a date range. Returns receipt summaries with date, warehouse name, total, item count, and transaction barcode (use barcode with get_receipt_detail for full items). Args: start_date: Start date as M/DD/YYYY (e.g. "1/01/2026"). Defaults to 90 days ago. end_date: End date as M/DD/YYYY (e.g. "3/31/2026"). Defaults to today. document_type: Filter: "all", "warehouse", "gas", "carwash". Defaults to "all". account: Account name (optional, uses default). |
| get_receipt_detailA | Get full itemized receipt detail for a warehouse purchase. Returns all line items with descriptions, prices, quantities, tax flags, plus payment tender details and tax breakdown. Args: barcode: Transaction barcode from list_warehouse_receipts account: Account name (optional, uses default). |
| list_online_ordersA | List online Costco.com orders for a date range. Returns order summaries with order number, date, total, status, and line items with descriptions and shipping info. Args: start_date: Start date as YYYY-M-DD (e.g. "2026-1-01"). Defaults to 90 days ago. end_date: End date as YYYY-M-DD (e.g. "2026-3-31"). Defaults to today. warehouse_number: Warehouse number (default "847"). page_number: Page number for pagination (default 1). page_size: Results per page (default 25). account: Account name (optional, uses default). |
| get_all_receipt_detailsA | Get full itemized details for ALL warehouse receipts in a date range. Fetches the receipt list then retrieves full details for each one. Args: start_date: Start date as M/DD/YYYY. Defaults to 90 days ago. end_date: End date as M/DD/YYYY. Defaults to today. account: Account name (optional, uses default). |
| lookup_productsA | Look up full Costco product names by item numbers. Uses a shared local cache — only calls the API for uncached items. Args: item_numbers: Comma-separated item numbers (e.g. "70476,5887,1532925") warehouse_number: Warehouse number (default "847") account: Account name (optional, uses default). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: auth status, receipt bulk/single detail, online orders, warehouse receipts, product lookup, and token management. There is no overlap or ambiguity between them.
All tools use a consistent verb_noun pattern with snake_case, such as check_auth_status, list_warehouse_receipts, and save_refresh_token. The naming is predictable and easy to understand.
Seven tools is an appropriate number for a Costco data retrieval server. It covers authentication, receipts, online orders, product lookup, and token management without being too few or excessive.
The tool set covers the main data retrieval needs, but there is a notable gap: check_auth_status references a nonexistent list_accounts tool. Adding that would improve completeness, though core operations are present.