home / mcp / blue archive mcp server

Blue Archive MCP Server

Provides real-time Blue Archive data via MCP for AI assistants, including students, equipment, stages, and media access.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "amxkifir-blue-archive-mcp": {
      "command": "npx",
      "args": [
        "blue-archive-mcp"
      ],
      "env": {
        "LOG_LEVEL": "info",
        "CACHE_TIMEOUT": "300000"
      }
    }
  }
}

You can run a Blue Archive MCP Server to access and query game data such as students, equipment, stages, items, and media through an MCP-compatible client. This server integrates real-time data from SchaleDB and exposes well-structured tools that let you search, filter, and retrieve rich information for seamless AI-assisted workflows.

How to use

To use the Blue Archive MCP Server, run it locally or against a remote MCP endpoint and connect your MCP-compatible client (for example Claude Desktop) using the provided configuration. You will access eight dedicated tools that let you search and filter data, fetch detailed information for individual students, browse equipment and stages, and retrieve avatars and media. Use language preferences (cn/jp/en) and apply filters such as school, star grade, categories, and rarity to tailor results. Enable detailed mode when you need full stats, or disable it for faster responses.

Usage patterns

- Start the server locally and point your MCP client to the local endpoint. - Use the get_students tool to list students with optional filters like language, search terms, limit, and detailed output. - Retrieve a specific student’s details with get_student_info. - Explore items, equipment, and stages with their respective tools, applying language, category, tier, or difficulty filters as needed. - Fetch an avatar with get_student_avatar to display portraits or collections in your preferred format.

Available tools

get_students

Retrieve student information with optional language, search, limit, and detail parameters to filter results.

get_student_info

Get detailed information for a specific student by ID with optional language preference.

get_student_by_name

Find a student by name across supported languages with optional detailed data.

get_raids

Retrieve raid information and boss data with optional language and detailed stats.

get_equipment

Browse equipment and weapons with optional category, tier, limit, and detailed stats.

get_stages

Access campaign and stage data with filters for area, chapter, difficulty, and search.

get_items

Retrieve consumable items and materials with optional rarity, category, tags, and detail flags.

get_student_avatar

Fetch student avatar images in various formats and variants.