`revision`

Pack: softwareheritage · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/revision for the schema, then POST the same URL with its arguments for the data.

Fetch one archived commit by its Software Heritage revision id (the 40-hex id, which for a git repository is the git commit sha). Returns the commit message, author and committer with their dates, the directory id of the tree it points at, and its parent commits. Accepts a bare hex id or a full SWHID (“swh:1:rev:”). Because the archive is content-addressed, this keeps resolving after the repository it came from has been renamed, moved or deleted. Sourced from the Software Heritage archive.

Parameters

Name	Type	Required	Description
`id`	string	yes	Revision id — a 40-character hex sha (“309cf37fe2a781279b7675d4bb7173198e532867”) or a SWHID (“swh:1:rev:309cf37f…”).

Example call

Arguments

{
  "id": "309cf37fe2a781279b7675d4bb7173198e532867"
}

curl

curl -X POST https://gateway.pipeworx.io/softwareheritage/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"revision","arguments":{"id":"309cf37fe2a781279b7675d4bb7173198e532867"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('revision', {
  "id": "309cf37fe2a781279b7675d4bb7173198e532867"
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the softwareheritage pack

{
  "mcpServers": {
    "softwareheritage": {
      "url": "https://gateway.pipeworx.io/softwareheritage/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

revision