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 server | Docs MCP server | |
|---|---|---|
| Use it to | Work with PIM data and indexed platform guidance | Explore published Bluestone PIM OpenAPI specifications and endpoint contracts |
| Authentication | Interactive Bluestone OAuth sign-in | No authentication for documentation discovery; a caller-supplied bearer token is required to run a live API request |
| Organization data | Uses the signed-in user's organization and permissions | Connecting alone does not grant access to organization data |
| Change risk | Includes permitted write and destructive operations | Four 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/mcpUse 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
- Connect and authenticate.
- Read Permissions and safe operation before allowing changes.
- Start with a read-only task from Common workflows.
- Use Troubleshooting and limitations if connection, access, or tool discovery fails.
Updated about 8 hours ago
