---
name: "xpay-awesome-lists"
description: "Browse and search curated awesome lists from GitHub"
version: "1.0.0"
provider: "Awesome Lists"
tools: 2
---

# Awesome Lists

Browse and search curated awesome lists from GitHub

## 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

```json
{
  "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](https://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

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
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](https://xpay.tools/skills/awesome-lists/find-awesome-section/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](https://xpay.tools/skills/awesome-lists/get-awesome-items/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