Get Awesome Items
get_awesome_itemsRetrieves items from a specific awesome list or section with token limiting. You must call 'find_awesome_section' first to discover available sections, UNLESS the user explicitly provides a githubRepo or listId.
When to Use
Use this tool when you need to retrieves items from a specific awesome list or section with token limiting. you must call 'find_awesome_section' first to discover available sections, unless the user explicitly provides a githubrepo or listid.. This is part of the Awesome Lists provider on xpay✦.
MCP Connection
Connect to xpay✦ to access this tool (and 1+ others):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
How to Execute
Use the xpay✦ meta-tools to run this tool:
xpay_details— Get full input schema:xpay_details("awesome-lists/get_awesome_items")xpay_run— Execute:xpay_run("awesome-lists/get_awesome_items", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
listId | string | No | UUID of the list (from find_awesome_section results) |
section | string | No | Category/section name to filter |
tokens | number | No | Maximum number of tokens to return (default: 10000). Higher values provide more items but consume more tokens. |
githubRepo | string | No | GitHub repo path (e.g., 'sindresorhus/awesome') from find_awesome_section results |
subcategory | string | No | Subcategory to filter |
offset | number | No | Pagination offset for retrieving more items |
Pricing
- Cost: $0.01/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Awesome Lists (all tools) — 2 tools
- Find Awesome Section — $0.01/call
Links
- Tool page: https://xpay.tools/awesome-lists/get-awesome-items/
- Provider: https://xpay.tools/awesome-lists/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
listId | string | No | UUID of the list (from find_awesome_section results) |
section | string | No | Category/section name to filter |
tokens | number | No | Maximum number of tokens to return (default: 10000). Higher values provide more items but consume more tokens. |
githubRepo | string | No | GitHub repo path (e.g., 'sindresorhus/awesome') from find_awesome_section results |
subcategory | string | No | Subcategory to filter |
offset | number | No | Pagination offset for retrieving more items |
Related Tools from Awesome Lists
Install Skill
Pricing
Cost
$0.01/call
Model
Flat rate
Provider
Awesome Lists