Good Nature Vibe Catalog

What Good Nature Vibe Vibe Catalog MCP server does

Good Nature Vibe Catalog provides read-only access to public information from goodnaturevibe.com. Its product tools cover catalog discovery and individual product records, including categories, brands, availability, variants, price ranges, and public product text. Separate knowledge tools expose CMS pages and blog posts as searchable or full plain text.

The server also returns the shop’s merchant profile and public contact path. It is intended for informational agent workflows around the Good Nature Vibe shop. It does not provide personal health advice and cannot perform commerce actions.

How it works

The hosted MCP endpoint is available at https://catalog-mcp.goodnaturevibe.com/mcp. It uses Streamable HTTP with JSON-RPC over POST and operates without login. Requests are stateless and responses contain JSON as text content.

Product data comes from the shop’s catalog feed. CMS and blog search results come from the content feed, while full page or post text is retrieved from public pages. Results include as_of and source fields. Feed and page responses are cached in memory for 10 minutes, allowing changes to reach agents without restarting the service.

Each tool accepts an optional store value. The default is nl; en, fr, es, and de are also supported. Text sourced from shop pages is marked as untrusted data and should not be treated as instructions.

Setup and configuration

A remote MCP client can connect directly to the hosted endpoint. For example, Claude Code can register it with:

claude mcp add --transport http gnv-catalog https://catalog-mcp.goodnaturevibe.com/mcp

For local operation, use Node.js 18 or newer. The project has no dependencies and starts with:

GNV_CATALOG_PORT=8325 node src/main.js

The local service binds to 127.0.0.1 by default. Configuration variables can change the shop origin, local port, bind address, and optional JSONL call log. The default shop origin is https://goodnaturevibe.com, and the server only fetches from that configured origin.

Tools and capabilities

• gnv_catalog_search searches or lists up to 20 catalog products, returning discovery information such as price in cents, availability, categories, brand, and short text.
• gnv_product retrieves one product by SKU, including its choices, price range, and public product-page text.
• gnv_knowledge_search searches or lists up to 100 CMS pages and blog posts, with optional filtering by CMSPage or BlogPost.
• gnv_knowledge returns the full plain text of one CMS page or blog post.
• gnv_profile returns the merchant name, website, store views, and currency.
• gnv_contact returns the shop’s public contact path.

All tools are annotated as read-only. The service also exposes health, server-card, AI-catalog, and crawler-information endpoints alongside the MCP endpoint.

Limitations and notes

Catalog prices are for discovery and are not checkout prices. The server cannot create or modify accounts, carts, orders, payments, or checkout sessions. It also does not expose private shop data.

Outbound requests are limited to the shop origin, do not follow redirects, time out after eight seconds, and enforce response size limits. Paths associated with checkout, customers, administration, REST, and GraphQL are refused. An optional call log records tool name, result code, duration, and a SHA-256 hash of arguments, but not IP addresses.