Hardcover API
Hardcover beta GraphQL API for authenticated access to book, edition, author, list, and reading-related metadata through a strongly typed GraphQL schema.
Connect this API to an AI agent Browse all specs
What you can do with Hardcover API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | /v1/graphql |
ExecuteGraphqlQuery | Execute GraphQL query Method: POST Path: /v1/graphql IMPORTANT: This function has 1 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - query: GraphQL query or mutation document. OPTIONAL: - variables: variables parameter from application/json |
Usage guide
## Authentication Create or sign in to a Hardcover account, open the account API settings, and generate a personal API token. Send it on every GraphQL request as `Authorization: Bearer YOUR_HARDCOVER_TOKEN`. Treat the token like a password and never commit it to source control. The official API is beta. Queries are intended for backend or offline use and are subject to documented timeouts, rate limits, and permissions. Start with the official health-check query `query { me { id username } }` to confirm authentication. ## Coverage This listing exposes the official GraphQL endpoint. The request body accepts the provider's normal GraphQL query/mutation structure; consult the schema/docs for current book, edition, author, list, and user fields.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Hardcover API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.