get_metadata

Pack: archive · Endpoint: https://gateway.pipeworx.io/archive/mcp

Get full metadata for an archived item by identifier. Returns title, creator, date, format, size, and access details.

Parameters

NameTypeRequiredDescription
idstringyesArchive.org item identifier (e.g., “principleofrelat00eins”, “ApolloMissionsMoonLandings”)

Example call

Arguments

{
  "id": "principleofrelat00eins"
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_metadata', {
  "id": "principleofrelat00eins"
});

More examples

{
  "id": "ApolloMissionsMoonLandings"
}

Response shape

Always returns: id, title, creator, date, description, mediatype, subjects, language, license_url, added_date, public_date, downloads, files_count, item_size_bytes, url, files

FieldTypeDescription
idstring | nullArchive.org item identifier
titlestring | nullItem title
creatorarrayList of item creators
datestring | nullPublication or creation date
descriptionstring | nullItem description
mediatypestring | nullMedia type
subjectsarrayList of subject tags
languagestring | nullPrimary language of the item
license_urlstring | nullURL to license information
added_datestring | nullDate item was added to archive
public_datestring | nullDate item was made public
downloadsnumber | nullNumber of downloads
files_countnumber | nullTotal number of files in item
item_size_bytesnumber | nullTotal size of item in bytes
urlstringDirect link to item on archive.org
filesarrayList of files (first 20)
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Archive.org item identifier"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Item title"
    },
    "creator": {
      "type": "array",
      "description": "List of item creators",
      "items": {
        "type": "string"
      }
    },
    "date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publication or creation date"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Item description"
    },
    "mediatype": {
      "type": [
        "string",
        "null"
      ],
      "description": "Media type"
    },
    "subjects": {
      "type": "array",
      "description": "List of subject tags",
      "items": {
        "type": "string"
      }
    },
    "language": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary language of the item"
    },
    "license_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL to license information"
    },
    "added_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date item was added to archive"
    },
    "public_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date item was made public"
    },
    "downloads": {
      "type": [
        "number",
        "null"
      ],
      "description": "Number of downloads"
    },
    "files_count": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total number of files in item"
    },
    "item_size_bytes": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total size of item in bytes"
    },
    "url": {
      "type": "string",
      "description": "Direct link to item on archive.org"
    },
    "files": {
      "type": "array",
      "description": "List of files (first 20)",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "File name"
          },
          "format": {
            "type": [
              "string",
              "null"
            ],
            "description": "File format"
          },
          "size_bytes": {
            "type": [
              "number",
              "null"
            ],
            "description": "File size in bytes"
          },
          "md5": {
            "type": [
              "string",
              "null"
            ],
            "description": "MD5 checksum of file"
          }
        },
        "required": [
          "name",
          "format",
          "size_bytes",
          "md5"
        ]
      }
    }
  },
  "required": [
    "id",
    "title",
    "creator",
    "date",
    "description",
    "mediatype",
    "subjects",
    "language",
    "license_url",
    "added_date",
    "public_date",
    "downloads",
    "files_count",
    "item_size_bytes",
    "url",
    "files"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

Regenerated from source · build May 9, 2026