Can I use BangumiMCP without a token?

Yes, without a token you can use all read-only tools (search, browse, get details) and access public user information. Write operations and private data require authentication.

What are the runtime requirements?

Python 3.10 or higher and the uv package manager (or pip). No other external dependencies are mentioned beyond those installed via the project's setup.

What credentials does it need?

It reads `BANGUMI_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Service MCP Server

bgm.tv MCP Server

Local serverstdioPython

What is the MCP Service MCP Server?

bgm.tv MCP Server

What you get

A Model Context Protocol (MCP) server that provides programmatic access to the Bangumi TV API, enabling AI assistants like Claude to interact with comprehensive anime, manga, music, game, and real-world media data.

55 MCP Tools — Complete coverage of Bangumi API endpoints
3 Workflow Prompts — Pre-built multi-step workflows for common tasks
1 Resource — Full OpenAPI specification for API documentation
Modular Architecture — Clean, maintainable codebase following MCP best practices
Type-Safe — Full Python type hints and enum definitions
Async Support — Non-blocking API calls using httpx

Configuration and credentials

Python 3.10 or higher - uv package manager (recommended) or pip

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_daily_broadcast	Weekly broadcast schedule
search_subjects	Full-text search with filters
browse_subjects	Category-based browsing
get_subject_details	Detailed subject information
get_subject_image	Subject image URL
get_subject_persons	Related creators/staff
get_subject_characters	Related characters
get_subject_relations	Related subjects
get_episodes	Episode list
get_episode_details	Episode information
search_characters	Character search
get_character_details	Character information
get_character_image	Character image URL
get_character_subjects	Subjects featuring character

Configuration

Python 3.10 or higher - uv package manager (recommended) or pip

Variable	Description	Required
BANGUMI_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use MCP Service to get daily broadcast.”
“Use MCP Service to search subjects.”
“Use MCP Service to browse subjects.”

Frequently asked questions

The token is optional but required for authenticated operations (collections, personal data), access to R18 content, and write operations (create, update, delete). Get a token at https://next.bgm.tv/demo/access-token.