ndl-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_RECEIPT_DIR | No | Directory where the receipt ledger file (ndl.jsonl) will be written. If unset, no receipts are written unless MCP_RECEIPT_LOG is set. | |
| MCP_RECEIPT_LOG | No | Path to a single log file for receipts, used when MCP_RECEIPT_DIR is unset. | |
| MCP_RECEIPT_SESSION | No | A project or article slug used to group queries in the receipt ledger. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ndl_search_booksA | Search 国立国会図書館蔵書 for books and monographs. Fields are combined with AND; title, creator, publisher and subject match partially. Returns the unified response envelope. Records are displayed, not stored. |
| ndl_search_national_bibliographyA | Search 国立国会図書館全国書誌情報. The national bibliography is the authority for Japanese imprint data — use it when a publication date, publisher or edition statement has to be right rather than merely plausible. |
| ndl_search_articlesA | Search 国立国会図書館雑誌記事索引, including the online-materials set. The index covers Japanese periodical articles, including many not in CiNii or J-STAGE. It indexes articles, not their full text. |
| ndl_search_digital_openB | Search 国立国会図書館デジタルコレクション（オープンデータ）. The open-data set only. The wider Digital Collections (ndl-dl, ndl-dl-online) are marked ○ for 非営利 use and so need no usage application, but they were outside the set this server declares and their metadata carries no open licence — displayable, not redistributable. Adding them is a documentation change here, not an application to the library. |
| ndl_search_allA | Search all five declared provider sets at once. Use when the material type is unknown. For a bibliographic check, the narrower tools return a cleaner set. |
| ndl_get_recordA | Retrieve a single record by NDL bibliographic ID or 全国書誌番号 (JP number). A fetch, not a search: the envelope omits |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |