MCP server

Parable is MCP-native. The catalog is exposed over a Model Context Protocol endpoint so AI agents can list and fetch components and templates directly, then run the install command they get back.

Endpoint

https://parable.dev/api/mcp

Streamable HTTP transport — JSON-RPC 2.0 over POST. A GET returns a human-readable description and the tool list.

Tools

Tool	Arguments	Returns
`list_components`	`category?`	All components, optionally filtered
`get_component`	`slug`	One component + its `shadcn add` command
`list_templates`	`family?`, `stack?`	All templates, optionally filtered
`get_template`	`slug`	One template + its `degit` clone command

Example

List the tools:

curl -X POST https://parable.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Fetch one component:

curl -X POST https://parable.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_component","arguments":{"slug":"shimmer-button"}}}'

The response's content[0].text is JSON with the component's metadata and the exact npx shadcn@latest add … command to install it.

Add it to a client

Parable is a remote, stateless Streamable-HTTP server — no install, no API key. Point any MCP-capable client at the endpoint below.

Domain note: the parable.dev custom domain is not live yet. Until it is, use the Vercel deployment URL: https://parable-three.vercel.app/api/mcp.

Claude Code

One command (or drop a .mcp.json in your project root):

claude mcp add --transport http parable https://parable-three.vercel.app/api/mcp

// .mcp.json
{
  "mcpServers": {
    "parable": {
      "type": "http",
      "url": "https://parable-three.vercel.app/api/mcp"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "parable": {
      "url": "https://parable-three.vercel.app/api/mcp"
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.parable]
url = "https://parable-three.vercel.app/api/mcp"

On older MCP clients that only speak stdio, bridge to the remote server with mcp-remote:

[mcp_servers.parable]
command = "npx"
args = ["-y", "mcp-remote", "https://parable-three.vercel.app/api/mcp"]

Use it

Once connected, ask your agent to "list Parable hero backgrounds" or "install the shimmer button", and it can browse and pull from the catalog directly.