# ActVer — Full Documentation

> GitHub Actions version lookup — REST API, MCP server, and web UI.

ActVer provides the latest version, commit SHA, and prerelease info for any GitHub Action. Cached and fast — no GitHub API token required.

## REST API

Base URL: `https://actver.dev`

### GET /v1/actions/{owner}/{repo}

Get the latest stable version, commit SHA, and metadata for a GitHub Action.

Request:
```
GET https://actver.dev/v1/actions/actions/checkout
```

Response:
```json
{
  "owner": "actions",
  "repo": "checkout",
  "major": "v4",
  "latest": "v4.2.2",
  "sha": "11bd71901bbe5b1630ceea73d27597364c9af683",
  "prerelease": null,
  "subdirectories": null,
  "released_at": "2025-01-09T19:53:28Z",
  "updated_at": "2025-01-10T00:00:00Z",
  "_meta": {
    "message": "ActVer is a free service. Support us!",
    "donate": "https://buymeacoffee.com/yetanother_yk"
  }
}
```

Fields:
- owner — GitHub organization or user
- repo — Repository name
- major — Latest major version tag (e.g. "v4")
- latest — Latest stable version tag (e.g. "v4.2.2")
- sha — Full commit SHA of the latest version
- prerelease — Prerelease info (version + sha) or null
- subdirectories — Action subdirectories (e.g. ["init", "analyze"] for github/codeql-action) or null
- released_at — ISO 8601 release timestamp
- updated_at — ISO 8601 last update timestamp

### GET /v1/actions/{owner}/{repo}/versions

List all major versions with their latest patch, SHA, and prerelease status.

Request:
```
GET https://actver.dev/v1/actions/actions/checkout/versions
```

Response:
```json
{
  "owner": "actions",
  "repo": "checkout",
  "versions": [
    { "major": "v4", "latest": "v4.2.2", "sha": "11bd71901bbe5b1630ceea73d27597364c9af683", "isPrerelease": false },
    { "major": "v3", "latest": "v3.6.0", "sha": "...", "isPrerelease": false }
  ],
  "updated_at": "2025-01-10T00:00:00Z"
}
```

### GET /v1/actions

List all indexed actions. Use `?include=popular` to also include popular actions from Analytics Engine.

Request:
```
GET https://actver.dev/v1/actions?include=popular
```

Response:
```json
{
  "actions": [
    { "owner": "actions", "repo": "checkout", "source": "manual" },
    { "owner": "actions", "repo": "setup-node", "source": "manual" },
    { "owner": "popular", "repo": "action", "source": "popular" }
  ]
}
```

Source values: "manual" (curated prefetch list), "auto" (auto-added by request count), "popular" (popular actions for sitemap).

### GET /v1/health

Service health check.

Response:
```json
{
  "status": "ok",
  "indexed_actions": 51,
  "last_sync": "2025-01-10T00:00:00Z"
}
```

### Error Responses

Errors follow RFC 9457 Problem Details format:

```json
{
  "type": "https://actver.dev/problems/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Action 'nonexistent/action' not found"
}
```

Status codes:
- 400 — Invalid owner or repo name
- 404 — Action not found
- 502 — GitHub API upstream error

### Caching

All responses include `Cache-Control: public, max-age=900, s-maxage=900, stale-while-revalidate=3600`. Data is updated hourly via cron.

## MCP Server

Endpoint: `https://actver.dev/mcp`
Transport: StreamableHTTP (POST only, stateless)

### Setup

Add to `.mcp.json`:

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

No API key or local process required.

### Tools

#### get_action_version

Get the latest stable version, commit SHA, and prerelease info for a GitHub Action. Use when pinning action versions in workflows or verifying whether an action is up to date.

Parameter:
- action (string, required) — Action identifier in owner/repo format (e.g. "actions/checkout")

#### list_action_versions

List all major versions of a GitHub Action with their latest patch, SHA, and prerelease status. Use when comparing versions across majors or auditing which major versions are still in use.

Parameter:
- action (string, required) — Action identifier in owner/repo format (e.g. "actions/checkout")

## Plugin & Skills

### Claude Code Plugin

```bash
claude plugin install actver-dev/skills
```

Includes MCP server, agent, and all skills (pin-actions, upgrade-actions, audit-actions).

### Skills.sh (Cursor, Copilot, etc.)

```bash
npx skills add actver-dev/skills
```

### Available Skills

- pin-actions — Pin workflow actions to full commit SHAs for security
- upgrade-actions — Upgrade GitHub Actions to their latest versions
- audit-actions — Audit CI/CD workflows for security issues

## Links

- Web UI: https://actver.dev
- GitHub: https://github.com/actver-dev
- Plugin source: https://github.com/actver-dev/skills
- Support: https://buymeacoffee.com/yetanother_yk