`search`

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

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

Search Internet Archive for texts, audio, video, and software by keyword. Returns item titles, identifiers, descriptions, and media types.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query (e.g., “subject:astronomy”, “creator:NASA”, “moon landing”)
`limit`	number	no	Number of results to return (1-100, default 20)

Example call

Arguments

{
  "query": "subject:astronomy"
}

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":"search","arguments":{"query":"subject:astronomy"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search', {
  "query": "subject:astronomy"
});

More examples

{
  "query": "creator:NASA moon landing",
  "limit": 50
}

Response shape

Always returns: total, results

Field	Type	Description
`total`	number	Total number of search results found
`results`	array	Array of search result items

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of search results found"
    },
    "results": {
      "type": "array",
      "description": "Array of search result items",
      "items": {
        "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 (e.g., texts, audio, video, software)"
          },
          "subjects": {
            "type": "array",
            "description": "List of subject tags",
            "items": {
              "type": "string"
            }
          },
          "downloads": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of downloads"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Direct link to item on archive.org"
          }
        },
        "required": [
          "id",
          "title",
          "creator",
          "date",
          "description",
          "mediatype",
          "subjects",
          "downloads",
          "url"
        ]
      }
    }
  },
  "required": [
    "total",
    "results"
  ]
}

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.

search