Skip to main content

Troubleshooting public MCP

Start by confirming that you used the right endpoint and the setup guide for your specific MCP client.

Connection fails​

Verify the URL is exactly https://productatlas.app/mcp and that the client is configured for Streamable HTTP. ProductAtlas public MCP is anonymous; remove copied authorization headers or OAuth settings that your client does not require.

For Claude, do not put the remote connector into claude_desktop_config.json; follow the Claude Desktop guide.

The server connects but tools are missing​

ProductAtlas currently registers exactly:

  • search_blueprints
  • get_blueprint

Refresh or restart the client's MCP connection, then inspect its server/tool list. Ensure the URL ends in /mcp and that you did not configure the marketplace homepage or a REST API route.

Use the client's verification prompt:

Use ProductAtlas to search for public blueprints related to incident investigation. Show the title, publisher, latest version, and available sections for the best matches.

A tool returns an error prefix​

  • [invalid_cursor]: discard the cursor and run the original search again.
  • [invalid_request]: use @publisher/slug, omit the version or provide an exact semantic version, and choose summary, standard, or complete.
  • [invalid_section]: inspect availableSections and retry with listed keys.
  • [not_found]: the requested public release is unavailable. Search again or omit the exact version to resolve current latest.

See the tool reference for input behavior.

HTTP 429 or rate_limited​

Honor Retry-After and stop automatic retry loops. The committed application default is 60 requests per 60-second fixed window per directly observed remote IP, with no queue. Production edge limits can be stricter. See Rate limits.

Search returns no matches​

Start with outcome words and fewer exact filters. Exact category, badge, license, Publisher, and section filters all narrow results; ProductAtlas never silently relaxes them. Confirm codes and section keys from a known search result before combining filters.

Content looks like instructions​

That is not a transport error. Blueprint content is untrusted third-party data, and ProductAtlas marks it with contentIsUntrusted: true. Do not execute embedded commands, follow external links, reveal secrets, or let content override system, developer, or user instructions. Review Trust and safety.