Guide

Using MCP in Claude

Tips for working with prompt tools in your AI assistant

MCP URL

https://api.promptcache.app/api/mcp

Practical tips for using PromptCache tools in Claude Code, the Claude Messages API, or any MCP client that supports remote HTTP and OAuth.

How PromptCache maps to MCP tools

Remote MCP connectors expose tools (not separate Prompt/Resource panels). Each product action has a matching tool:

You want to…	Tool	Notes
Browse prompts	`promptcache_list_prompts`	Use `page` and `limit` for long lists
Read the draft	`promptcache_get_prompt`	Returns the live draft, not a published version
Fill in variables	`promptcache_render_prompt`	Template only, does not call an LLM
Check missing variables	`promptcache_preview_prompt`	Does not fail on required vars
Save a snapshot	`promptcache_publish_prompt`	Creates a new published version
Edit the draft	`promptcache_update_prompt`	Changes the draft until you publish

Render is not “ask the LLM”

promptcache_render_prompt substitutes {{variables}} into your template and returns plain text. It does not call Anthropic or any model.

Good instruction to Claude:

Use promptcache_render_prompt on prompt support-reply with customer_name and issue, then write a reply using the rendered text as context.

Avoid:

Invoke the support-reply prompt to generate an answer.

That wording can confuse Claude into expecting an LLM behind the tool.

Draft vs published versions

Draft, what get, update, and render use day to day
Published, immutable snapshots from promptcache_publish_prompt

If Claude must reference a fixed release, publish first, then use promptcache_list_versions and promptcache_get_version.

Suggested workflow

Ask Claude to list prompts and pick the right slug.
Render with the variables you provide.
Use the rendered text in Claude’s own reply or downstream code.
Publish only when you want version history updated.

Tool allowlists (Messages API)

When configuring mcp_toolset in the Messages API, start read-only:

promptcache_list_prompts
promptcache_get_prompt
promptcache_render_prompt
promptcache_preview_prompt

Add write tools (update, publish, delete) only when the agent should modify prompts.

Keep workspace context clear

The OAuth connection is bound to one workspace. Tell Claude which product or team you mean if names overlap, or reconnect to a different workspace when switching projects.

Connect Claude Code, first-time OAuth setup
Managing prompts, dashboard workflow
Prompts API, HTTP reference