# Awesome Lists
> Browse and search curated awesome lists from GitHub.

## Website
https://github.com/bh-rat/context-awesome

## Portal
https://awesome-lists.on.xpay.sh

## MCP Servers

### Awesome Lists
Browse and search curated awesome lists from GitHub
URL: https://awesome-lists.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY
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)
- 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)

## Get Started
1. Get an API key at https://awesome-lists.on.xpay.sh/account/keys
2. Add the MCP server URL to your client config (Claude, Cursor, Windsurf)
3. Pay per tool call from your XPay wallet

## About
Powered by XPay — pay-per-use API access for AI agents.
https://xpay.sh