O'Reilly Learning MCP server for AI agents
Let Claude, ChatGPT or your own agent read O'Reilly Learning: 3 typed functions through one MCP server. No O'Reilly Learning API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just O'Reilly Learning
An MCP server for O'Reilly Learning alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/oreillyEvery site
One MCP server for O'Reilly Learning and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 3
getContentMetadataReads O'Reilly's metadata for one or more content URNs (books, videos) via GET /api/v2/metadata/.Arguments
Name Type Required args{ ourns: string[]; limit?: number }Yes Returns
OreillyMetadataPageinterface OreillyContentMetadata { identifier: string; ourn: string; name: string; type: string | null; description: string | null; status: string | null; language: string | null; publicationDate: string | null; publishers: string[]; topics: string[]; contentLevels: string[]; durationSeconds: number | null; edition: string | null; webUrl: string | null; popularity: number | null; } interface OreillyMetadataPage { count: number; results: OreillyContentMetadata[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/oreilly/getContentMetadataCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.oreilly.getContentMetadata({ ourns: ["urn:orm:book:9781492056348"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.oreilly.getContentMetadata({"ourns": ["urn:orm:book:9781492056348"]}))curl -X POST https://api.bowmark.ai/v1/sites/oreilly/getContentMetadata \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"ourns":["urn:orm:book:9781492056348"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.oreilly.getContentMetadata({ ourns: ["urn:orm:book:9781492056348"] });getMetadataByUrlsBatch-resolves O'Reilly content api paths (e.g. /api/v1/book/<isbn>/) via POST /api/v1/metadata/ to title, authors, publishers, format, issued date…Arguments
Name Type Required args{ urls: string[] }Yes Returns
OreillyUrlMetadata[]interface OreillyUrlMetadata { apiUrl: string; identifier: string; ourn: string | null; title: string; type: string | null; contentFormat: string | null; authors: string[]; publishers: string[]; issued: string | null; language: string | null; pageCount: number | null; parentTitle: string | null; topics: string[]; webUrl: string | null; coverUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/oreilly/getMetadataByUrlsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.oreilly.getMetadataByUrls({ urls: ["/api/v1/book/9781492056348/"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.oreilly.getMetadataByUrls({"urls": ["/api/v1/book/9781492056348/"]}))curl -X POST https://api.bowmark.ai/v1/sites/oreilly/getMetadataByUrls \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"urls":["/api/v1/book/9781492056348/"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.oreilly.getMetadataByUrls({ urls: ["/api/v1/book/9781492056348/"] });searchSearches the O'Reilly Learning catalog of books, videos and courses by keyword via the site's own /api/v1/search/, returning ranked titles with…Arguments
Name Type Required querystringE.g. "kubernetes", "fluent python".Yes pagenumber0-based.No limitnumber1-10, default 10.No Returns
OreillySearchPageinterface OreillySearchResult { title: string; format: string | null; // "book", "video", … archiveId: string; ourn: string | null; // pass to getContentMetadata authors: string[]; publishers: string[]; issued: string | null; description: string | null; topics: string[]; webUrl: string | null; coverUrl: string | null; apiUrl: string | null; // pass to getMetadataByUrls pages: number | null; durationSeconds: number | null; } interface OreillySearchPage { query: string; page: number; total: number; hasMore: boolean; results: OreillySearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/oreilly/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.oreilly.search({ query: "kubernetes" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.oreilly.search({"query": "kubernetes"}))curl -X POST https://api.bowmark.ai/v1/sites/oreilly/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"kubernetes"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.oreilly.search({ query: "kubernetes" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/oreilly/<function> - OpenAPI
/v1/sites/oreilly/openapi.json