カーリル for AI

Library Search

search_libraries

図書館名や地域で図書館を検索して蔵書検索に必要なシステムIDを取得します。応答単位はシステムで複数の図書館が一つのシステムに含まれます。利用者が登録した学校図書館も返します。

このAPIキーで蔵書検索できるのは、search_books の説明にある図書館だけです。

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "search_libraries"
  }
}

Input Schema

Name	Required	Description	Default
`limit`	No	取得件数(省略時10)
`keyword`	No	キーワード

Output Schema

Name	Required	Description
`count`	No	検索結果件数
`notice`	No	利用者に伝える案内（APIキーの期限や今月の残り回数）
`reason`	No	失敗時の理由
`success`	No	成功したか
`libraries`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 6, 2026

TDQS

A3.5/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

アノテーションが openWorldHint=true(外部データ参照)と destructiveHint=false を既に示している。説明は『応答単位はシステムで複数の図書館が一つに含まれる』『利用者登録の学校図書館も返す』という返却特性を追加しており付加価値があるが、認証・レート制限や readOnlyHint=false との整合には触れていない。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

目的が冒頭に置かれ、システム単位の返却や APIキー制約といった重要情報が簡潔に続く。無駄な文は少ないが、キー制約の一文は構成上やや唐突で、もう少し統合できる余地がある。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

出力スキーマが存在するため戻り値の説明は不要で、説明は『システム単位でまとまる』という重要な解釈上の注意を提供している。2パラメータ・低複雑度のツールとして必要な情報はほぼ揃っている。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

スキーマ記述カバレッジが100%のため、limit と keyword の意味はスキーマ側で完結している。説明は『図書館名や地域で検索』と keyword の用途を暗示するが、構文や形式の追加情報はなく、ベースライン3が妥当。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

明確に動詞(検索)+リソース(図書館)を述べ、目的(蔵書検索に必要なシステムIDの取得)まで示している。search_books との関係にも触れており、兄弟ツールとの区別は概ね可能だが、get_ndc_info との違いには触れていない。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

『蔵書検索に必要なシステムIDを取得する』という後続用途(search_books)を暗示しており、利用シーンは推測できる。しかし、いつ search_libraries を search_books の代わりに使うべきか、除外条件や前提は明示されていない。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All カーリル for AI tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?