Cities MCP: a simple MCP server for managing Web pages in your Neocities sites

This is an stdio-only, Python-based MCP server that allows your coding agent to manage your Neocities web pages: list, sync, upload and do everything else that an official free-tier Neocities API allows. Additionally, it supports managing multiple accounts at once, thanks to the config format invented for the Multicities site manager.

Disclaimer: this, as well as Multicities, is a purely hobbyist project that is not affiliated with Neocities hosting in any possible way. It makes use of the official Neocities API that may at any moment become outdated or subject to additional restrictions without prior notice or updates to this package. Use at your own risk and discretion.

Installation

You'll need uv as a prerequisite, although you can build the package using different methods.

First, clone the repo and run uv build:

git clone https://codeberg.org/luxferre/cities-mcp.git
cd cities-mcp
uv build

Then, configure your coding agent.

For Gemini CLI/Antigravity/Cursor/Claude etc, the configuration should look like this:

"mcpServers": {
  //...
  "neocities": {
    "command": "uv",
    "args": [
      "run",
      "--directory",
      "/path/to/your/cities-mcp",
      "cities-mcp"
    ]
  },
  //...
}

For OpenCode, it should look like this:

"mcp": {
  //...
  "neocities": {
    "type": "local",
    "enabled": true,
    "command": ["uv", "run", "--directory", "/path/to/your/cities-mcp", "cities-mcp"]
  },
  //...
}

Account configuration

The Neocities account config file format is fully compatible with the one used in Multicities. Just log in with either Multicities or directly via your coding agent using this server's login tool, and you're ready to go.

Credits

Created by Luxferre in 2026, released into public domain with no warranties.