# `HexpmMcp.Toolbox`
[🔗](https://github.com/joshrotenberg/hexpm-mcp/blob/main/lib/hexpm_mcp/toolbox.ex#L1)

Client for the Elixir Toolbox API (https://elixir-toolbox.dev).

Elixir Toolbox is a curated discovery layer over hex.pm: a maintained
taxonomy of groups and categories, trending packages, and search. The API
is public, requires no authentication, and returns package objects enriched
with GitHub/GitLab stats, a popularity score, and health flags.

Responses are wrapped in a `{"data": ...}` envelope; each function unwraps it
and returns parsed maps. Results are cached via `HexpmMcp.Cache`.

# `category_projects`

List curated projects in a category.

## Options

  * `:sort` - result ordering. The API recognizes `"name"` (alphabetical) and
    `"downloads"`, and falls back to popularity order for any other value.

# `group`

Get a single group by slug.

# `groups`

List all groups, each with its categories.

# `search`

Search packages by query string.

# `trending`

List trending projects.

## Options

  * `:limit` - maximum number of projects to return.

---

*Consult [api-reference.md](api-reference.md) for complete listing*