Bluestone PIM MCP overview

Understand the operational Bluestone PIM MCP server, how it differs from the docs MCP server, and where to start.

Bluestone PIM MCP overview

The Bluestone PIM product MCP server lets a supported AI assistant work with Bluestone PIM through structured tools. After you sign in, the assistant can inspect organization data, perform actions allowed by your Bluestone permissions, and search indexed Bluestone platform guidance.

This is an operational connection. Available tools can create, update, archive, or delete PIM data. The server acts with the organization access and permissions of the signed-in user.

Product MCP or docs MCP?

Bluestone provides two distinct MCP experiences:

Product MCP serverDocs MCP server
Use it toWork with PIM data and indexed platform guidanceExplore published Bluestone PIM OpenAPI specifications and endpoint contracts
AuthenticationInteractive Bluestone OAuth sign-inNo authentication for documentation discovery; a caller-supplied bearer token is required to run a live API request
Organization dataUses the signed-in user's organization and permissionsConnecting alone does not grant access to organization data
Change riskIncludes permitted write and destructive operationsFour discovery tools are read-only; execute-request can make the API request supplied by the caller

Use the product MCP server when you want an assistant to work directly in Bluestone PIM. Use the Bluestone PIM docs MCP server when you want an assistant to research the Management API for an integration.

What the product MCP server covers

The product MCP server provides tools for:

  • Products, variants, attributes, catalogs, categories, and contexts
  • Assets, labels, relations, and completeness information
  • History, asynchronous job status, tasks, and users
  • Indexed Bluestone platform guidance, including recently updated content

See the Bluestone PIM MCP tool reference for the compact catalog. Your MCP client displays each tool's parameters, required fields, and result details.

Current availability

The product MCP endpoint for Production EU is:

https://mcp-core-public.bluestonepim.com/mcp

Use only the endpoint supplied for your environment. Do not construct production or regional URLs by changing this hostname. Production and other regional product-MCP endpoints have not been verified for this guide set.

Recommended path

  1. Connect and authenticate.
  2. Read Permissions and safe operation before allowing changes.
  3. Start with a read-only task from Common workflows.
  4. Use Troubleshooting and limitations if connection, access, or tool discovery fails.

Did this page help you?