# Hex.pm MCP

> MCP server for hex.pm and hexdocs.pm: search, inspect, compare, and audit Elixir packages

- name: io.github.joshrotenberg/hexpm-mcp
- version: 0.3.1
- connection class: R0 (autonomous)
- trust: 90/100
- quality: 72/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.joshrotenberg%2Fhexpm-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.joshrotenberg%2Fhexpm-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "hexpm-mcp": {
      "type": "http",
      "url": "https://hexpm-mcp.fly.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-127d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 72/100 (needs work)

### protocol: 100 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 60000)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: health (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); readme (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); release (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,346 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 24 tool changes in 30 days
- fail `stability.rug_pull`: 8 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 24, about 1,346 tokens to load them all
- tool set hash: c9fe2786d66db39c903f2cd5c3a3f885
- tools last changed: 2026-09-27T17:25:16.877Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.joshrotenberg/hexpm-mcp.svg)](https://protogrid.dev/servers/io.github.joshrotenberg/hexpm-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-27 `versions` changed (title, description)
  - before: List all versions of a hex.pm package.
  - after: List all package versions
- 2026-09-27 `upgrade_check` changed (title, description) **meaning changed**
  - before: Check which mix.exs dependencies have newer versions available.
  - after: Check mix.exs dependencies for upgrades
- 2026-09-27 `toolbox_trending` changed (title, description)
  - before: List trending Elixir packages from Elixir Toolbox.
  - after: List trending Elixir packages
- 2026-09-27 `toolbox_search` changed (title, description) **meaning changed**
  - before: Search packages via Elixir Toolbox. Results carry GitHub/GitLab stats, popularity, and health signals not exposed by the raw hex.pm search.
  - after: Search packages through Elixir Toolbox
- 2026-09-27 `toolbox_groups` changed (title, description, inputSchema)
  - before: Browse the Elixir Toolbox curated taxonomy of groups and categories.
  - after: Browse the Elixir Toolbox taxonomy
- 2026-09-27 `toolbox_group` changed (title, description)
  - before: List the categories in a single Elixir Toolbox group.
  - after: List categories in a Toolbox group
- 2026-09-27 `toolbox_category` changed (title, description)
  - before: List the curated projects in an Elixir Toolbox category.
  - after: List projects in a Toolbox category
- 2026-09-27 `search_docs` changed (title, description)
  - before: Search within a package's documentation by name.
  - after: Search within package documentation
- 2026-09-27 `search` changed (title, description) **meaning changed**
  - before: Search for packages on hex.pm by name/keywords.
  - after: Search hex.pm packages
- 2026-09-27 `release` changed (title, description)
  - before: Get detailed information about a specific package release.
  - after: Get detailed package release information

Full history: https://api.protogrid.dev/v1/servers/io.github.joshrotenberg%2Fhexpm-mcp/changes

## Remotes

- https://hexpm-mcp.fly.dev/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (24)

- `alternatives`: Find alternative packages
- `audit`: Audit package dependencies for risks
- `audit_mix_deps`: Audit mix.exs dependencies for risks
- `compare`: Compare 2-5 packages side by side
- `dependencies`: Get dependencies for a package version
- `dep_tree`: Build a package dependency tree
- `doc_item`: Get documentation for a module or function
- `docs`: Browse a package documentation module listing
- `downloads`: Get package download statistics
- `features`: Get optional features for a package release
- `health`: Run a comprehensive package health check
- `info`: Get detailed package information
- `owners`: Get package owners and maintainers
- `readme`: Get package README content
- `release`: Get detailed package release information
- `search`: Search hex.pm packages
- `search_docs`: Search within package documentation
- `toolbox_category`: List projects in a Toolbox category
- `toolbox_group`: List categories in a Toolbox group
- `toolbox_groups`: Browse the Elixir Toolbox taxonomy
- `toolbox_search`: Search packages through Elixir Toolbox
- `toolbox_trending`: List trending Elixir packages
- `upgrade_check`: Check mix.exs dependencies for upgrades
- `versions`: List all package versions