---
name: "xpay-awesome-lists-find-awesome-section"
description: "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."
version: "1.0.0"
price: "$0.01/call"
provider: "Awesome Lists"
---

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

**Provider:** Awesome Lists
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to 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.. This is part of the Awesome Lists provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 1+ others):

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

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("awesome-lists/find_awesome_section")`
2. **`xpay_run`** — Execute: `xpay_run("awesome-lists/find_awesome_section", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | number | No | Maximum sections to return |
| `query` | string | Yes | Search terms for finding sections across awesome lists |
| `confidence` | number | No | Minimum confidence score (0-1) |

## Pricing

- **Cost:** $0.01/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Awesome Lists (all tools)](https://xpay.tools/skills/awesome-lists/SKILL.md) — 2 tools
- [Get Awesome Items](https://xpay.tools/skills/awesome-lists/get-awesome-items/SKILL.md) — $0.01/call

## Links

- Tool page: https://xpay.tools/awesome-lists/find-awesome-section/
- Provider: https://xpay.tools/awesome-lists/
- All tools: https://xpay.tools/explore