nekopoi-mcp

MCP server for https://nekopoi.care — Hentai / JAV / 3D with Indonesian subs.

Scrapes via cheerio (no API key). All tools return JSON.

Install

npm install
npm run build

Run

node dist/index.js        # stdio MCP
# or
npm start

MCP Client Config

{
  "mcpServers": {
    "nekopoi": {
      "command": "node",
      "args": ["/absolute/path/to/nekopoi-mcp/dist/index.js"]
    }
  }
}

For opencode, add to opencode.json:

{
  "mcp": {
    "nekopoi": { "type": "local", "command": ["node", "./dist/index.js"], "enabled": true }
  }
}

Tools

Tool	Description
nekopoi_latest	Latest episodes from homepage (page)
nekopoi_search	Search ?s= (query, page)
nekopoi_series	Series detail by URL (/hentai/<slug>/) — synopsis, genres, episodes
nekopoi_episode	Episode detail by URL — download links per quality (360p/480p/720p/1080p/4K), streaming servers
nekopoi_genre	List by genre slug (vanilla, milf, uncensored, …)
nekopoi_category	List by category: hentai / 2d-animation / 3d-hentai / jav / jav-cosplay
nekopoi_genre_list	All genres from /genre-list
nekopoi_hentai_list	A-Z from /hentai-list
nekopoi_jav_list	A-Z from /jav-list
nekopoi_random	Hit /random

Site is behind Cloudflare; requests use a browser User-Agent. If blocked, set CF_CLEARANCE cookie handling externally.

Disclaimer

Site states it hosts no files; all content is third-party. This MCP only scrapes publicly available metadata/links.

License

MIT