Nekoweb

• Don't commit them. If your MCP config lives in a project (e.g. .vscode/mcp.json), use your client's secret prompt, like the VS Code button above does, instead of pasting them into the file.
• Regenerate the key if it leaks. Generating a new key at https://nekoweb.org/api makes the old one stop working. For a leaked session token, log out of nekoweb.org to end that session.
• Limit local uploads. Set NEKOWEB_LOCAL_ROOT to your site project's folder so the assistant can only upload files from there. See Configuration.

claude mcp add nekoweb -e NEKOWEB_API_KEY=your-api-key -- npx -y nekoweb-mcp-server

Open Settings → Developer → Edit Config, add the server to claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "nekoweb": {
      "command": "npx",
      "args": ["-y", "nekoweb-mcp-server"],
      "env": {
        "NEKOWEB_API_KEY": "your-api-key",
        "NEKOWEB_SESSION_TOKEN": "your-session-token"
      }
    }
  }
}

For the API key only, remove the NEKOWEB_SESSION_TOKEN line (and the comma before it).

• nekoweb_get_site_info - Get a site's title, domain, views, followers, update count and dates (read-only)

  • site: Domain of another public site, e.g. yoursite.nekoweb.org. Omit for your own site (string, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_list_sites - List every site on your account, with its stats and the folder that holds its files (read-only)

  • response_format: markdown (default) or json (string, optional)

• nekoweb_get_limits - Show how many API requests you have left and when each limit resets (read-only)

  • response_format: markdown (default) or json (string, optional)

• nekoweb_list_folder - List the files and folders in a folder (read-only)

  • path: Folder to list, e.g. /mysite.nekoweb.org/blog. Defaults to / (string, optional)
  • recursive: Also list subfolders. Each subfolder uses one API request, up to 25 per call (boolean, optional)
  • max_depth: How many levels of subfolders to list, 1–10, default 3 (number, optional)
  • limit: Maximum entries to return, 1–500, default 100 (number, optional)
  • offset: Entries to skip, for paging through large folders (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_read_file - Read a file's source exactly as stored, SSI directives included. Images up to 5 MB are shown as images (read-only)

  • path: File to read, e.g. /mysite.nekoweb.org/index.html (string, required)
  • offset: Character to start reading from, for long files (number, optional)
  • max_chars: Maximum characters to return, default 20,000 (number, optional)

• nekoweb_write_file - Create a text file or replace its whole content

  • path: File to write, e.g. /mysite.nekoweb.org/index.html (string, required)
  • content: The complete new content of the file (string, required)
  • mode: create_or_overwrite (default) writes the file whether or not it exists; edit_existing fails if it doesn't (string, optional)

• nekoweb_create - Create an empty file or a new folder

  • path: Path to create, e.g. /mysite.nekoweb.org/blog (string, required)
  • is_folder: true for a folder, false for an empty file (boolean, required)

• nekoweb_move - Rename or move a file or folder

  • from: Current path (string, required)
  • to: New path. Its parent folder must exist (string, required)

• nekoweb_delete - Permanently delete a file or folder, including everything inside it

  • path: Path to delete (string, required)

• nekoweb_upload_file - Upload files of any type into a folder, replacing files with the same name. Files over 95 MB are uploaded in chunks automatically

  • folder: Destination folder, e.g. /mysite.nekoweb.org/images. It must already exist (string, optional)
  • local_paths: Full paths of files on your computer (string[], optional)
  • files: Files given as base64, each with a name and content_base64 (object[], optional)

• nekoweb_import_zip - Upload a .zip and extract it into a folder, replacing files with the same paths

  • folder: Folder to extract into, e.g. /mysite.nekoweb.org (string, optional)
  • zip_local_path: Full path of a .zip on your computer (string, optional)
  • zip_base64: The .zip as base64, if not using zip_local_path (string, optional)

• nekoweb_get_site_settings - Show the folder a site serves and its options: main site, nice links, strict slashes, listed in Explore, posts in the global feed, HTTP access and NSFW (read-only)

  • site: Domain of one of your sites, e.g. mysite.nekoweb.org. Omit for the site the API key belongs to (string, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_update_site_settings - Change some of a site's settings; the ones you leave out stay as they are. Turning nice links off or changing the folder can break links to your site

  • site: Domain of one of your sites. Omit for the site the API key belongs to (string, optional)
  • main, nice_links, strict_slash, visible, show_in_global_feed, support_http, nsfw: Turn an option on or off (boolean, optional)
  • folder: Folder the site serves its files from, e.g. /mysite.nekoweb.org. It must exist (string, optional)

• nekoweb_get_tags - List the tags on one of your sites, and how many of the allowed tags it uses (read-only)

  • site: Domain of one of your sites, e.g. mysite.nekoweb.org. Omit for the site the API key belongs to (string, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_add_tag - Add a tag to one of your sites. Sites can have up to 10 tags

  • site: Domain of one of your sites. Omit for the site the API key belongs to (string, optional)
  • tag: The tag, 2 to 32 characters, e.g. pixel-art (string, required)

• nekoweb_remove_tag - Remove a tag from one of your sites

  • site: Domain of one of your sites. Omit for the site the API key belongs to (string, optional)
  • tag: The tag to remove (string, required)

• nekoweb_get_stats_history - Get the day-by-day history of a site's views, followers and updates, like the charts on its statistics page (read-only)

  • site: Domain of one of your sites. Omit for the site the API key belongs to (string, optional)
  • period: month (default), year or all. Nekoweb only shows year and all on paid tiers (string, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_list_followers - List the sites that follow one of your sites, with each one's title, link, screenshot and whether you follow it back (read-only)

  • site: Domain of one of your sites. Omit for the site the API key belongs to (string, optional)
  • sort: follow_date (default), recently_updated or most_followed (string, optional)
  • page: Fetch only this page. Omit to fetch every page, up to 20 (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_search_sites - Search the sites on Nekoweb's Explore page by name or tag. With the session token, results also say which sites you follow (read-only)

  • query: Text to search for. Name searches match part of the domain, tag searches need the exact tag. Omit to browse all sites (string, optional)
  • by: name (default) or tag (string, optional)
  • sort: most_viewed (default), most_followed, least_viewed, recently_updated, newest or oldest (string, optional)
  • page: Page of results, about 50 sites each, default 1 (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_get_news - Get the latest announcements from nekoweb.org's news page, newest first (read-only)

  • limit: How many posts to return, 1 to 100, default 5 (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_get_global_feed - Get the newest posts from all Nekoweb sites, from the global RSS feed (read-only)

  • limit: How many posts to return, 1 to 50, default 20 (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_get_feed - Get the latest posts from the sites you follow, as shown on your feed (read-only, needs the session token)

  • page: Page of the feed, newest first, default 1 (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_list_following - List the sites you follow, grouped by the day each was last updated. Nekoweb leaves out sites their owners hid from Explore (read-only, needs the session token)

  • page: Fetch only this page. Omit to fetch every page, up to 20 (number, optional)
  • response_format: markdown (default) or json (string, optional)

• nekoweb_follow_site - Follow or unfollow a site. Checks first, so it only changes something when needed (needs the session token)

  • site: Domain of the site, e.g. fairfruit.nekoweb.org (string, required)
  • follow: true to follow (default), false to unfollow (boolean, optional)