Developers

MCP Server

The Model Context Protocol (MCP) exposes your ParetoStudio library to any MCP-compatible AI client. Connect once and Claude Desktop, Cursor, Claude Code, and others can read, search, and — on Pro — create items in your library from natural language. Installing agents and skills as on-disk files targets Claude Code specifically (it writes the Claude Code .claude/ layout).

Library Skills tab showing 12 saved skills with trigger metadata and categories — Everything in your library is addressable from the IDE. 19 tools, one API key, zero copy-paste.

Prefer a guided setup?

Use the setup wizard at /setup/mcp. It picks your client, creates an API key, and verifies the connection in four steps. Continue reading if you want the manual walkthrough.

Prerequisites

ParetoStudio account

Any plan including Free. Free gets 50 requests/day; Pro unlocks 500/day and unlimited saves.

API key

Generate one in Settings → Developer. Starts with psk_.

Node.js 18+

npx paretostudio-mcp fetches the latest bundle. No global install required.

Setup

Paste the ParetoStudio MCP block into your client's config, fill in your PARETOSTUDIO_API_KEY, and restart the client. Pick the tab that matches where you work.

Settings - Developer panel showing MCP Server Configuration block ready to copy — Developer tab → copy the config → paste into your client.

Config path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)

If the file doesn't exist, create it with the content below. The Claude/folder is only created after Claude Desktop has been launched at least once — if you don't see it, open Claude Desktop first, then come back.

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "paretostudio": {
      "command": "npx",
      "args": ["paretostudio-mcp"],
      "env": {
        "PARETOSTUDIO_API_KEY": "psk_your_key_here"
      }
    }
  }
}

Restart after every config change

Most MCP clients do not hot-reload. After editing the config, quit and relaunch Claude Desktop, or reload the window in Cursor / Claude Code.

Verify install

After restarting your client, confirm ParetoStudio is wired up. Each tab below shows the success signal for one client.

Open a new chat. Click the tools icon (slider) in the chat input — you should see paretostudio in the MCP server list with 9 to 19 tools enumerated (count depends on your plan).

If you see this, you're done. Otherwise jump to Troubleshooting.

First command

Ask your AI: “list my prompts”. If it returns your library (or an empty list for a new account), MCP is working.

Available tools

Nineteen tools across read, install, write, and delete. Ask your AI client in natural language — it picks the right tool automatically.

Read

9 tools· Browse, fetch, and search every item in your library.

`list_prompts`	List all prompts in your library.
`get_prompt`	Fetch the full content of a specific prompt by ID.
`search_prompts`	Search prompts by title, description, or content.
`list_agents`	List all agents in your library.
`get_agent`	Fetch the full configuration of a specific agent.
`search_agents`	Search agents by name or description.
`list_skills`	List all skills in your library.
`get_skill`	Fetch the full configuration of a specific skill.
`search_skills`	Search skills by name or description.

Install

3 tools· Drop agents and skills into a local project.

`install_agent`	Download an agent and save it as a .md file under .claude/agents/.
`install_skill`	Download a skill and save it as SKILL.md under .claude/skills/.
`install_bundle`	Install an agent and multiple skills in one operation — full workspace ready.

Write

5 tools· Create and update library items from your IDE.

`create_prompt`	Create a new prompt in your library.	Pro
`create_agent`	Create a new agent in your library.	Pro
`update_agent`	Update an existing agent.	Pro
`create_skill`	Create a new skill in your library.	Pro
`update_skill`	Update an existing skill.	Pro

Delete

2 tools· Remove items from your library. The client confirms before deletion.

`delete_agent`	Delete an agent from your library.	Pro
`delete_skill`	Delete a skill from your library.	Pro

Read and install are on every plan

Any plan that has MCP access can browse, search, and install. Create, update, and delete require Pro. See rate limits for per-plan request caps.

Usage examples

Ask your AI client naturally. Here is what a few common requests look like and which tool they resolve to.

Browse

“List all my agents”

What the AI does behind the scenes

list_agents()

Find something specific

“Search my prompts for code review”

What the AI does behind the scenes

search_prompts({ query: "code review" })
// → returns matches sorted by relevance

Install to a project

“Install my Backend Engineer agent into this project”

What the AI does behind the scenes

install_agent({
  agent_id: "ag_01H...",
  path: "./.claude/agents/backend-engineer.md"
})

Bundle agent + skills

“Install my QA agent with the testing and bug-report skills”

What the AI does behind the scenes

install_bundle({
  agent_id: "ag_01H...",
  skill_ids: ["sk_...", "sk_..."],
  path: "./"
})

Create from your IDE (Pro)

“Save this system prompt as a new agent called API Reviewer”

What the AI does behind the scenes

create_agent({
  name: "API Reviewer",
  system_prompt: "..."
})

Rate limits

Requests are capped per plan and reset every 24 hours. Hit the cap and the API returns 429 with a Retry-After header.

Plan	Daily requests	Tool access
Free	50	Read + Install + Write (capped at 2/2)
ProRecommended	500	All 19 tools (read, install, write, delete)

Troubleshooting

npx not found, hangs, or fails to fetch

The MCP config uses npx paretostudio-mcp — that requires Node.js 18+ and a reachable npm registry.

Run node --version — upgrade if below 18.
Run npm config get registry — should print https://registry.npmjs.org/. On a corporate proxy, point it at your mirror or set HTTPS_PROXY.
First invocation downloads ~500 KB and can take 10–20s on slow links — let it finish before restarting the client.

Server loads but 0 tools appear

The MCP process started, but the client shows zero tools. Three usual suspects:

API key revoked or rotated — open Settings → Developer and confirm the key is still listed.
API key is from a Free account that has hit the 50-request daily cap. Upgrade in Settings → Billing for 500/day.
Missing psk_ prefix or a stray space when you pasted — re-paste the full key into env.PARETOSTUDIO_API_KEY and restart.

PARETOSTUDIO_API_KEY not set

The key must live in the env block of your MCP config, not in args. After saving the config, fully quit and reopen the client — most MCP clients do not hot-reload configuration.

Tools not appearing

Restart your AI client after editing the config. In Claude Desktop, quit and relaunch. In Cursor, reload the window (Cmd+Shift+P → Reload Window). In Claude Code, re-open the session.

API key not found or revoked

The key has been rotated or deleted. Generate a fresh one in Settings → Developer, copy the full psk_ prefix, and paste it back into your MCP config.

Rate limit exceeded (429)

You hit the daily request cap. The response includes a Retry-After header with the seconds until reset. Upgrade your plan for a higher cap.

Permission denied (403) on create / update / delete

Write tools are available on Free (capped at 2 agents / 2 skills) and unlimited on Pro. If you see 403 on a create/update/delete tool, you have hit the Free entity cap — upgrade in Settings → Billing.

Chrome Extension

API Keys

Back to Homepage

Developers

MCP Server

Prefer a guided setup?

Use the setup wizard at /setup/mcp. It picks your client, creates an API key, and verifies the connection in four steps. Continue reading if you want the manual walkthrough.

Prerequisites

ParetoStudio account

Any plan including Free. Free gets 50 requests/day; Pro unlocks 500/day and unlimited saves.

API key

Generate one in Settings → Developer. Starts with psk_.

Node.js 18+

npx paretostudio-mcp fetches the latest bundle. No global install required.

Setup

Paste the ParetoStudio MCP block into your client's config, fill in your PARETOSTUDIO_API_KEY, and restart the client. Pick the tab that matches where you work.

Config path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "paretostudio": {
      "command": "npx",
      "args": ["paretostudio-mcp"],
      "env": {
        "PARETOSTUDIO_API_KEY": "psk_your_key_here"
      }
    }
  }
}

Restart after every config change

Most MCP clients do not hot-reload. After editing the config, quit and relaunch Claude Desktop, or reload the window in Cursor / Claude Code.

Verify install

After restarting your client, confirm ParetoStudio is wired up. Each tab below shows the success signal for one client.

Open a new chat. Click the tools icon (slider) in the chat input — you should see paretostudio in the MCP server list with 9 to 19 tools enumerated (count depends on your plan).

If you see this, you're done. Otherwise jump to Troubleshooting.

First command

Ask your AI: “list my prompts”. If it returns your library (or an empty list for a new account), MCP is working.

Available tools

Nineteen tools across read, install, write, and delete. Ask your AI client in natural language — it picks the right tool automatically.

Read

9 tools· Browse, fetch, and search every item in your library.

`list_prompts`	List all prompts in your library.
`get_prompt`	Fetch the full content of a specific prompt by ID.
`search_prompts`	Search prompts by title, description, or content.
`list_agents`	List all agents in your library.
`get_agent`	Fetch the full configuration of a specific agent.
`search_agents`	Search agents by name or description.
`list_skills`	List all skills in your library.
`get_skill`	Fetch the full configuration of a specific skill.
`search_skills`	Search skills by name or description.

Install

3 tools· Drop agents and skills into a local project.

`install_agent`	Download an agent and save it as a .md file under .claude/agents/.
`install_skill`	Download a skill and save it as SKILL.md under .claude/skills/.
`install_bundle`	Install an agent and multiple skills in one operation — full workspace ready.

Write

5 tools· Create and update library items from your IDE.

`create_prompt`	Create a new prompt in your library.	Pro
`create_agent`	Create a new agent in your library.	Pro
`update_agent`	Update an existing agent.	Pro
`create_skill`	Create a new skill in your library.	Pro
`update_skill`	Update an existing skill.	Pro

Delete

2 tools· Remove items from your library. The client confirms before deletion.

`delete_agent`	Delete an agent from your library.	Pro
`delete_skill`	Delete a skill from your library.	Pro

Read and install are on every plan

Any plan that has MCP access can browse, search, and install. Create, update, and delete require Pro. See rate limits for per-plan request caps.

Usage examples

Ask your AI client naturally. Here is what a few common requests look like and which tool they resolve to.

Browse

“List all my agents”

What the AI does behind the scenes

list_agents()

Find something specific

“Search my prompts for code review”

What the AI does behind the scenes

search_prompts({ query: "code review" })
// → returns matches sorted by relevance

Install to a project

“Install my Backend Engineer agent into this project”

What the AI does behind the scenes

install_agent({
  agent_id: "ag_01H...",
  path: "./.claude/agents/backend-engineer.md"
})

Bundle agent + skills

“Install my QA agent with the testing and bug-report skills”

What the AI does behind the scenes

install_bundle({
  agent_id: "ag_01H...",
  skill_ids: ["sk_...", "sk_..."],
  path: "./"
})

Create from your IDE (Pro)

“Save this system prompt as a new agent called API Reviewer”

What the AI does behind the scenes

create_agent({
  name: "API Reviewer",
  system_prompt: "..."
})

Rate limits

Requests are capped per plan and reset every 24 hours. Hit the cap and the API returns 429 with a Retry-After header.

Plan	Daily requests	Tool access
Free	50	Read + Install + Write (capped at 2/2)
ProRecommended	500	All 19 tools (read, install, write, delete)

Troubleshooting

npx not found, hangs, or fails to fetch

The MCP config uses npx paretostudio-mcp — that requires Node.js 18+ and a reachable npm registry.

Run node --version — upgrade if below 18.
Run npm config get registry — should print https://registry.npmjs.org/. On a corporate proxy, point it at your mirror or set HTTPS_PROXY.
First invocation downloads ~500 KB and can take 10–20s on slow links — let it finish before restarting the client.

Server loads but 0 tools appear

The MCP process started, but the client shows zero tools. Three usual suspects:

API key revoked or rotated — open Settings → Developer and confirm the key is still listed.
API key is from a Free account that has hit the 50-request daily cap. Upgrade in Settings → Billing for 500/day.
Missing psk_ prefix or a stray space when you pasted — re-paste the full key into env.PARETOSTUDIO_API_KEY and restart.

PARETOSTUDIO_API_KEY not set

The key must live in the env block of your MCP config, not in args. After saving the config, fully quit and reopen the client — most MCP clients do not hot-reload configuration.

Tools not appearing

Restart your AI client after editing the config. In Claude Desktop, quit and relaunch. In Cursor, reload the window (Cmd+Shift+P → Reload Window). In Claude Code, re-open the session.

API key not found or revoked

The key has been rotated or deleted. Generate a fresh one in Settings → Developer, copy the full psk_ prefix, and paste it back into your MCP config.

Rate limit exceeded (429)

You hit the daily request cap. The response includes a Retry-After header with the seconds until reset. Upgrade your plan for a higher cap.

Permission denied (403) on create / update / delete

Chrome Extension

API Keys

Back to Homepage