Awesome Lists

Browse and search curated awesome lists from GitHub

Available Tools (2)

• find_awesome_section: Discovers sections/categories across awesome lists matching a search query and returns matching sections from awesome lists.

You MUST call this function before 'get_awesome_items' to discover available sections UNLESS the user explicitly provides a githubRepo or listId.

Selection Process:

1. Analyze the query to understand what type of resources the user is looking for
2. Return the most relevant matches based on:
   • Name similarity to the query and the awesome lists section
   • Category/section relevance of the awesome lists
   • Number of items in the section
   • Confidence score

Response Format:

• Returns matching sections of the awesome lists with metadata
• Includes repository information, item counts, and confidence score
• Use the githubRepo or listId with relevant sections from results for get_awesome_items

For ambiguous queries, multiple relevant sections will be returned for the user to choose from. — $0.01/call

• get_awesome_items: 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. — $0.01/call

Quick Start

{
  "mcpServers": {
    "awesome-lists": {
      "url": "https://awesome-lists.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
    }
  }
}

Pricing

$0.01 per tool call. Pay per use from your XPay wallet. No subscriptions.

Get an API key at xpay.tools.

Tools: 2 Category: Utility & Reference

When to Use

Use Awesome Lists tools when you need to browse and search curated awesome lists from github. All tools are available through xpay✦'s single MCP connection.

MCP Connection

{
  "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"

Available Tools

• Find Awesome Section — Discovers sections/categories across awesome lists matching a search query and returns matching sections from awesome lists.

You MUST call this function before 'get_awesome_items' to discover available sections UNLESS the user explicitly provides a githubRepo or listId.

Selection Process:

1. Analyze the query to understand what type of resources the user is looking for
2. Return the most relevant matches based on:
   • Name similarity to the query and the awesome lists section
   • Category/section relevance of the awesome lists
   • Number of items in the section
   • Confidence score

Response Format:

• Returns matching sections of the awesome lists with metadata
• Includes repository information, item counts, and confidence score
• Use the githubRepo or listId with relevant sections from results for get_awesome_items

For ambiguous queries, multiple relevant sections will be returned for the user to choose from. — $0.01/call — SKILL.md

• Get Awesome Items — 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. — $0.01/call — SKILL.md

How to Execute

1. xpay_discover — Search for tools: xpay_discover("awesome-lists")
2. xpay_details — Get input schema: xpay_details("awesome-lists/TOOL_NAME")
3. xpay_run — Execute: xpay_run("awesome-lists/TOOL_NAME", { ...inputs })
4. xpay_balance — Check credits

Links

• Provider page: https://xpay.tools/awesome-lists/
• All providers: https://xpay.tools/explore
• Docs: https://docs.xpay.sh