`get_metadata`

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

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

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

Parameters

Name	Type	Required	Description
`id`	string	yes	Archive.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

Field	Type	Description
`id`	string \| null	Archive.org item identifier
`title`	string \| null	Item title
`creator`	array	List of item creators
`date`	string \| null	Publication or creation date
`description`	string \| null	Item description
`mediatype`	string \| null	Media type
`subjects`	array	List of subject tags
`language`	string \| null	Primary language of the item
`license_url`	string \| null	URL to license information
`added_date`	string \| null	Date item was added to archive
`public_date`	string \| null	Date item was made public
`downloads`	number \| null	Number of downloads
`files_count`	number \| null	Total number of files in item
`item_size_bytes`	number \| null	Total size of item in bytes
`url`	string	Direct link to item on archive.org
`files`	array	List 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.

get_metadata