Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use NDL Search with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Japan's National Diet Library as an MCP: search 100M+ records. books, journals, dissertations, digitized Meiji/Edo classics. by title, author, publisher or IS

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 3 capabilities

The complete NDL Search capability set.

These are the exact actions your AI can choose when you ask it to work with NDL Search.

Capability set01 / 01

01-03

3 capabilities in this set.

Part of 3 available through NDL Search.

  1. 01

    Find book by isbn

    The fastest way to get authoritative Japanese bibliographic data for a book. NOTE: the NDL API requires the hyphenated ISBN form. this capability inserts the hyphens automatically. Look up one book in the NDL catalog by ISBN-13 or ISBN-10

  2. 02

    Search national library

    Query modes: title= (book/article titles), any= (all fields), creator= (author), publisher=. Japanese terms work best; English also matches many records. Returns title, author, publisher, date, ISBN, subjects, categories and NDL page URL. NOTE: the API has no server-side pagination. set cnt to the window you need (max ~200). Search the National Diet Library of Japan: 100M+ books, journals, dissertations, digitized classics and government documents

  3. 03

    Search digitized history

    Ideal for 明治/江戸 era books, historical documents, old maps and journals that are digitized and free to read. Returns digitized item metadata with NDL viewer links. Search NDL Digitized Collections: scanned Japanese classics, Meiji-era books, rare documents (all free)

One connector, every AI

NDL Search works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put NDL Search to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 3 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of NDL Search, so you can see the experience inside your AI.

It does not authenticate your account with NDL Search. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

NDL Search Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_1KHZON53bo83KKBQFQ5L9hXvIX9xS0yeWF03PVow/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — NDL Search capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ndl-japan-library-search-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_1KHZON53bo83KKBQFQ5L9hXvIX9xS0yeWF03PVow/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? link.label

See all the AI clients this connector works with ↑

FAQ

Questions NDL Search owners ask.

  • 01

    Do I need an API key or registration?

    No. The NDL Search OpenSearch API is fully public. all capabilities work without authentication.

  • 02

    Does the API support pagination?

    The NDL OpenSearch endpoint has no server-side pagination (tested: pagenum/first/start params are ignored). Each call returns the top 'cnt' results (up to ~200). For deeper results, refine the query terms instead of paging.

Explore

More in Government Public Data

Suggestions