get_volume
Pack: google-books · 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/get_volume for the schema, then POST the same URL with its arguments for the data.
Volume detail (full title, authors, description, categories, page count, links).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | Google Books volume id |
Example call
Arguments
{
"id": "zyTCAlFPjgYC"
}curl
curl -X POST https://gateway.pipeworx.io/google-books/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_volume","arguments":{"id":"zyTCAlFPjgYC"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('get_volume', {
"id": "zyTCAlFPjgYC"
});Response shape
| Field | Type | Description |
|---|---|---|
kind | string | Resource kind (books#volume) |
id | string | Unique volume identifier |
etag | string | Entity tag for caching |
selfLink | string | Link to this volume resource |
volumeInfo | object | Detailed volume metadata |
saleInfo | object | Sale and pricing information |
accessInfo | object | Access and viewability information |
Full JSON Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Resource kind (books#volume)"
},
"id": {
"type": "string",
"description": "Unique volume identifier"
},
"etag": {
"type": "string",
"description": "Entity tag for caching"
},
"selfLink": {
"type": "string",
"description": "Link to this volume resource"
},
"volumeInfo": {
"type": "object",
"description": "Detailed volume metadata",
"properties": {
"title": {
"type": "string",
"description": "Full book title"
},
"subtitle": {
"type": "string",
"description": "Book subtitle"
},
"authors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Author names"
},
"publisher": {
"type": "string",
"description": "Publisher name"
},
"publishedDate": {
"type": "string",
"description": "Publication date"
},
"description": {
"type": "string",
"description": "Detailed book description"
},
"industryIdentifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ISBN_10 or ISBN_13"
},
"identifier": {
"type": "string",
"description": "ISBN value"
}
}
},
"description": "ISBN and other identifiers"
},
"readingModes": {
"type": "object",
"properties": {
"text": {
"type": "boolean",
"description": "Text reading mode available"
},
"image": {
"type": "boolean",
"description": "Image reading mode available"
}
},
"description": "Available reading modes"
},
"pageCount": {
"type": "number",
"description": "Total number of pages"
},
"printType": {
"type": "string",
"description": "BOOK or MAGAZINE"
},
"categories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Subject categories and classifications"
},
"averageRating": {
"type": "number",
"description": "Average user rating (0-5)"
},
"ratingsCount": {
"type": "number",
"description": "Number of ratings"
},
"language": {
"type": "string",
"description": "ISO 639-1 language code"
},
"imageLinks": {
"type": "object",
"properties": {
"smallThumbnail": {
"type": "string",
"description": "URL to small thumbnail"
},
"thumbnail": {
"type": "string",
"description": "URL to thumbnail"
}
},
"description": "Book cover image links"
},
"previewLink": {
"type": "string",
"description": "Link to book preview"
},
"infoLink": {
"type": "string",
"description": "Link to book info page"
},
"canonicalVolumeLink": {
"type": "string",
"description": "Canonical link to volume"
}
}
},
"saleInfo": {
"type": "object",
"description": "Sale and pricing information",
"properties": {
"country": {
"type": "string",
"description": "Country code"
},
"saleability": {
"type": "string",
"description": "FOR_SALE, NOT_FOR_SALE, FREE_EBOOKS, etc"
},
"isEbook": {
"type": "boolean",
"description": "Whether available as ebook"
},
"listPrice": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Price amount"
},
"currencyCode": {
"type": "string",
"description": "Currency code"
}
},
"description": "List price"
},
"retailPrice": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Price amount"
},
"currencyCode": {
"type": "string",
"description": "Currency code"
}
},
"description": "Retail price"
},
"buyLink": {
"type": "string",
"description": "Link to purchase"
}
}
},
"accessInfo": {
"type": "object",
"description": "Access and viewability information",
"properties": {
"country": {
"type": "string",
"description": "Country code"
},
"viewability": {
"type": "string",
"description": "FULL, PARTIAL, NO_PAGES, UNKNOWN"
},
"embeddable": {
"type": "boolean",
"description": "Whether embeddable"
},
"publicDomain": {
"type": "boolean",
"description": "Whether in public domain"
},
"textToSpeechPermission": {
"type": "string",
"description": "Text-to-speech permission level"
},
"epub": {
"type": "object",
"properties": {
"isAvailable": {
"type": "boolean",
"description": "EPUB format availability"
},
"acsTokenLink": {
"type": "string",
"description": "ACS token link for EPUB"
}
},
"description": "EPUB format details"
},
"pdf": {
"type": "object",
"properties": {
"isAvailable": {
"type": "boolean",
"description": "PDF format availability"
},
"acsTokenLink": {
"type": "string",
"description": "ACS token link for PDF"
}
},
"description": "PDF format details"
},
"webReaderLink": {
"type": "string",
"description": "Link to web reader"
},
"accessViewStatus": {
"type": "string",
"description": "FULL, SAMPLE, EXCERPT, etc"
}
}
}
}
}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 google-books pack
{
"mcpServers": {
"google-books": {
"url": "https://gateway.pipeworx.io/google-books/mcp"
}
}
}See Getting Started for client-specific install steps.