GroupeZ Docs

MCP server

groupez.dev exposes a Model Context Protocol server, so AI assistants (Claude, ChatGPT, Cursor, VS Code Copilot…) can search the marketplace and read resource pages directly.

https://groupez.dev/mcp
TransportStreamable HTTP, POST only (a GET returns 405)
AuthenticationNone
AccessRead-only
Server nameGroupeZ, version 1.0.0

Public and read-only

The server answers exactly what a logged-out visitor of the website can read: published resources, unlisted resources whose id is known, their versions and the category tree. Drafts and private resources answer "not found", as an id that never existed would. No tool takes or exposes an account, and downloading a resource still requires a GroupeZ account on the website.

Connecting a client

Claude Code

claude mcp add --transport http groupez https://groupez.dev/mcp

Claude (claude.ai and Claude Desktop)

Settings → Connectors → Add custom connector, then enter https://groupez.dev/mcp as the URL. No OAuth configuration is needed.

ChatGPT

Custom MCP servers are added as connectors, which requires developer mode:

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Back in Apps & Connectors, click Create.
  3. Name the connector GroupeZ, enter https://groupez.dev/mcp as the MCP server URL, and choose No authentication.
  4. In a conversation, enable the GroupeZ connector from the tools menu (+).

Plans and menus

Developer mode is not available on the free plan. On Business, Enterprise and Edu workspaces, an admin may have to allow custom connectors first. OpenAI moves these settings regularly: if the menu differs, look for "Developer mode" in the settings. Since every GroupeZ tool is read-only, plans that limit custom connectors to read actions are enough.

Cursor

In .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "groupez": {
      "url": "https://groupez.dev/mcp"
    }
  }
}

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "groupez": {
      "type": "http",
      "url": "https://groupez.dev/mcp"
    }
  }
}

Any other client

Any client that supports remote MCP servers over HTTP works with the URL above. Clients that only support stdio can go through a bridge such as mcp-remote:

{
  "mcpServers": {
    "groupez": {
      "command": "npx",
      "args": ["mcp-remote", "https://groupez.dev/mcp"]
    }
  }
}

Tools

The server offers four tools, all annotated read-only. Every answer is Markdown text and carries the public URL of the page it comes from.

search_resources

Searches the catalogue. It returns the same page, in the same order, as the website's /resources listing with the same filters: 24 results per page, each with its id, price, rating, downloads, current version, author, category and URL.

ArgumentTypeDescription
querystring, max 80Free-text search, typo tolerant (auction house, zmenu).
categorystringA category slug from list_categories. A section includes its subcategories. An unknown slug is a validation error.
pricefree | paidFilter by price.
minecraft_versionstring, max 20Only resources declaring this Minecraft version, e.g. 1.21.
sortrecent | downloads | rating | nameDefaults to recent (latest release first).
pageinteger ≥ 1Page number.

Every argument is optional. With none, the tool lists the most recently updated resources. If the search engine is unreachable, the tool returns an error instead of an empty page. Retry later, or search without query.

get_resource

Returns the full sheet of one resource: summary, author, category, current version, price, compatibility, description, FAQ and source URL. It is the same document as the page's Markdown version (/resources/{slug}.{id}.md).

ArgumentTypeDescription
idinteger ≥ 1, requiredThe resource id, as returned by search_resources.

list_resource_versions

Returns the release history of one resource, newest first by version number (so 1.10 comes before 1.9), with release date, file size and changelog. Each changelog is cut at 1,500 characters.

ArgumentTypeDescription
idinteger ≥ 1, requiredThe resource id.
limitinteger 1–50How many versions to return, 10 by default.

list_categories

Returns the category tree: sections, then their subcategories, each with the slug that search_resources accepts and its number of published resources. It takes no arguments.

Rate limiting

/mcp uses the same api limiter as the public API: 120 requests per minute per IP. Each tool call is one request. Past the limit, the server answers 429.

Example

A request to an assistant connected to the server:

What is the most downloaded resource on GroupeZ?

The assistant calls search_resources with sort: "downloads". The first line of the answer looks like this:

- **zAuctionHouse** — The best auction house plugin, mandatory for your server. (id 1, 12.00 EUR, 10,602 downloads, v4.0.1.4, by Maxlego08, General) https://groupez.dev/resources/zauctionhouse.1

The raw JSON-RPC call, for clients you write yourself:

curl -X POST https://groupez.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_resources","arguments":{"sort":"downloads"}}}'

Introduction

Previous Page

API

Next Page

On this page

Connecting a clientClaude CodeClaude (claude.ai and Claude Desktop)ChatGPTCursorVS CodeAny other clientToolssearch_resourcesget_resourcelist_resource_versionslist_categoriesRate limitingExample
GroupeZ MCP

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.