Endfield MCP

Name: Endfield MCP
Author: 3aKHP

Read-only lore, character and story lookup for Arknights: Endfield, aimed at fan writers

By 3aKHP (individual) TypeScript Local · stdio Knowledge and memory Web search

GitHub npm Website

30 popularity score ★ 6 ↓ 139/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal

claude mcp add endfield -- bunx endfield-mcp

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "endfield": {
      "command": "bunx",
      "args": [
        "endfield-mcp"
      ]
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "endfield": {
      "command": "bunx",
      "args": [
        "endfield-mcp"
      ]
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "endfield": {
      "type": "stdio",
      "command": "bunx",
      "args": [
        "endfield-mcp"
      ]
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.endfield]
command = "bunx"
args = ["endfield-mcp"]

Gemini CLITerminal

gemini mcp add --scope user endfield bunx -- endfield-mcp

Local (from source)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

FirstTerminal

git clone https://github.com/3aKHP/Endfield-MCP.git
cd Endfield-MCP/ts
bun install

Claude CodeTerminal

claude mcp add endfield -- bun run '<ABSOLUTE_PATH_TO_CLONE>/ts/src/server.ts'

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "endfield": {
      "command": "bun",
      "args": [
        "run",
        "<ABSOLUTE_PATH_TO_CLONE>/ts/src/server.ts"
      ]
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "endfield": {
      "command": "bun",
      "args": [
        "run",
        "<ABSOLUTE_PATH_TO_CLONE>/ts/src/server.ts"
      ]
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "endfield": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "run",
        "<ABSOLUTE_PATH_TO_CLONE>/ts/src/server.ts"
      ]
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.endfield]
command = "bun"
args = ["run", "<ABSOLUTE_PATH_TO_CLONE>/ts/src/server.ts"]

Gemini CLITerminal

gemini mcp add --scope user endfield bun -- run '<ABSOLUTE_PATH_TO_CLONE>/ts/src/server.ts'

Settings 8

`EF_TRANSPORT`	Optional: stdio (default) or http for the Streamable HTTP server.
`EF_DATA_PATH`	Optional: Absolute path to your own game-data folder; setting it turns off the auto-sync.
`EF_WIKI_ENDPOINT`	Optional: Wiki API address, default https://endfield.wiki.gg/api.php.
`EF_WIKI_UA`	Optional: User-Agent sent to the wiki; defaults to a Chrome-style string.
`EF_WIKI_REFERER`	Optional: Referer sent to the wiki, default https://endfield.wiki.gg/.
`PORT`	Optional: HTTP listen port in http mode, default 3000.
`HOST`	Optional: HTTP listen host in http mode, default 0.0.0.0.
`GITHUB_MIRRORS`	Optional: Comma-separated proxy mirror URLs for data downloads.

What it does

Endfield MCP is a fan-made server for people writing fan fiction or other fan work around the game Arknights: Endfield. It puts two kinds of source within reach of an MCP client: the community-run Endfield Talos Wiki (endfield.wiki.gg), queried live through its MediaWiki API, and a text-only copy of in-game data (characters, story scenes and, from 0.4.0, the in-game archive and encyclopedia) that the author mirrors on their own host.

Wiki tools search pages and return a page's plain text, section list, categories, links and template fields. Character tools list operators and return their archive texts, voice lines and basic profile numbers. Story tools browse chapters and scenes and run regex searches over scene dialogue. Lore tools search and read in-game archive documents and encyclopedia entries.

Game data comes from a two-layer store: at start-up the server syncs data from the mirror in the background into a per-user data folder, and until that finishes it falls back to data bundled inside the package. Setting EF_DATA_PATH points it at your own folder and turns the sync off. It runs over stdio by default, or as a stateless Streamable HTTP server with EF_TRANSPORT=http.

The README describes version 0.3.1 and its 15 tools; the npm release 0.4.0 registers 19, adding ef_list_lore_categories, ef_search_lore, ef_read_lore_document and ef_get_wiki_entry (ts/src/server.ts and ts/src/tools/worldviewTools.ts at tag v0.4.0). Tool descriptions are written in Chinese; wiki text comes back in English.

What it needs

Runtime	Node.js

Bun 1.2 or later: the published program starts with a bun shebang and the HTTP mode uses Bun's own server, so plain Node is not enough. Internet access to endfield.wiki.gg for the wiki tools and to the author's mirror (or GitHub) for the game-data sync. No account or key.

Limits

Read-only: it fetches and searches text. Game data is text only, with no images or audio. Story and lore searches take a regex of up to 200 characters; ef_search_lore returns 30 results by default, up to 100 with max_results. Until the background sync finishes, game-data tools answer from the bundled copy or report that no data is available. Wiki calls send a browser-style User-Agent because the wiki's firewall blocks plain bots; if the wiki changes that, wiki tools may fail. The README still documents 0.3.1 and lists 15 of the 19 tools. In HTTP mode it listens on 0.0.0.0 port 3000 unless HOST and PORT say otherwise, and the README names no sign-in for that endpoint.

Who it suits

Suits Endfield fans and fan writers who want an assistant to look up characters, voice lines, story scenes and world lore while drafting, and who are happy to install Bun. It only reads public game text, so it carries little risk to accounts or files. Players of the original Arknights should use its sibling PRTS-MCP, which the README names. Anyone after live account data, gacha records or gameplay help beyond lore will not find it here.

Tools 19

ef_search_wiki: Keyword search over the Endfield Talos Wiki
ef_read_wiki_page: Returns a wiki page as plain text, optionally one section
ef_list_wiki_sections: Lists the section headings of a wiki page
ef_get_wiki_categories: Lists the categories a wiki page belongs to
ef_get_wiki_links: Lists links from a wiki page, or pages linking to it
ef_get_wiki_template: Returns a page's template fields as key-value data
ef_list_characters: Lists all characters with name, class and rarity
ef_search_characters: Regex search across character data fields
ef_get_character_archives: Returns a character's background archive texts
ef_get_character_voices: Returns a character's voice lines and when they play
ef_get_character_basic_info: Returns a character's profile numbers such as class, rarity and voice actor
ef_list_story_chapters: Lists the story chapters
ef_list_stories: Lists the scenes inside one story chapter
ef_read_story: Returns the full dialogue of one story scene
ef_search_stories: Regex search over the text of all story scenes
ef_list_lore_categories: Shows the category trees of the in-game archive and encyclopedia
ef_search_lore: Regex search over in-game archive documents
ef_read_lore_document: Returns the full text of one archive document by its ID
ef_get_wiki_entry: Returns an in-game encyclopedia entry and its linked archive document

Popularity

30 popularity score

★ 6 ↓ 139/wk

GitHub stars, whole repository	6	10.1 points
Stars in 30 days	+2	2.4 points
npm downloads, last week	139	17.2 points

It lives in the folder ts of 3akhp/endfield-mcp, which holds more than this server. Its stars are the whole repository's, so in the score they never count for more than its own downloads.

Measured 2026-11-07. How the score works.

Where it is published

Code	3akhp/endfield-mcp/ts ★ 6, the whole repository
npm	endfield-mcp 0.4.0, 2026-06-29

What it can reach

Runs	On your machine
Reaches	The internet, Files on your machine
Changes things	No: it reads only
Sign-in	None
Licence	MIT (npm)
Last code change	2026-06-29

Runs on your machine. Its tools only read: they query the public endfield.wiki.gg API and read game text from local files. In the background it downloads a data bundle from the author's mirror into a per-user data folder (skipped when EF_DATA_PATH is set). Wiki requests imitate a browser User-Agent and Referer to get past the wiki's firewall. No key or account is needed. In http mode it binds to 0.0.0.0:3000 by default with no sign-in described, so anyone who can reach that port can call it.

Over time

GitHub stars, whole repository 6 +2 (+50 %)

13 Oct 20267 Nov 2026

npm downloads a week 139 −680 (−83 %)

17k7

29 Jun 20267 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 30 −12 (−29 %)

4220

13 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-14.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![Endfield MCP on EveryMCPServer](https://everymcpserver.com/badge/endfield-mcp.svg)](https://everymcpserver.com/servers/endfield-mcp)

Connect your client

Add in one click

Or add it by command or config

Add in one click

Or add it by command or config

Settings 8

What it does

What it needs

Limits

Who it suits

Tools 19

Similar servers

Anytype MCP Server

Ganjoor MCP Server

llmwiki

Memanto MCP Server

Karakeep MCP Server

PraisonAI MCP