Skip to main content
Glama
Sign In
Bangumi MCP

Bangumi MCP

by etherwindy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

post_my_collection

Idempotent

Add or update a collection for a Bangumi subject by setting the watch status, tags, and comment.

Instructions

为当前用户收藏指定条目，如果已收藏则更新

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "subject_id": "<subject_id>"
    },
    "name": "post_my_collection"
  }
}

Input Schema

NameRequiredDescriptionDefault
subject_idYes条目ID
paramsNo可选参数，包含以下字段：

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already provide readOnlyHint=false, destructiveHint=false, idempotentHint=true. The description adds the key behavioral detail that the tool updates the entry if it already exists, which supplements the idempotency hint. However, it does not disclose permissions or side effects beyond what the annotations imply. With annotations present, the description adds moderate value.

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?

The description is a single, short sentence that conveys the core action efficiently. It is front-loaded and contains no extraneous information. While minimal, it earns its place. No verbose or redundant phrases.

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

Completeness3/5

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

The description adequately covers the main behavior for a tool with 2 parameters (one required, one nested object) and an existing output schema. However, it does not mention the scope ('current user') beyond the name, nor does it address potential error states or race conditions. Given the available annotations and schema, it is minimally complete but leaves some gaps.

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?

Schema description coverage is 100%, so each parameter already has a detailed explanation in the input schema (e.g., type, tags, comment). The description does not add extra meaning beyond the schema's own parameter descriptions. For high coverage, baseline is 3, and no additional value is provided.

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

Purpose5/5

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

The description clearly states the action: 'collect specified item, update if already collected'. It identifies the resource (current user's collection) and verb (create/update). The name 'post_my_collection' aligns with a POST operation for the user's collection, effectively distinguishing from read tools like get_my_collection or delete tools like delete_index_collection.

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

Usage Guidelines2/5

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

No explicit guidance on when to use this tool versus alternatives like patch_my_collection (partial update) or other collection mutation tools. The description does not state any prerequisites, who can use it, or when it should be preferred. The implicit purpose is clear, but the agent has no explicit direction to avoid misuse.

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

Deploy Server

Other Tools