Skip to main content

​
Prerequisites

  • Node.js
  • A project already initialized with Next.js
  • An Account at ChipiPay Dashboard
  • A created project in clerk
  • npm or pnpm as a package manager
  • Tailwind CSS configured
The MCP server provides a bridge between your development environment and our component registry, enabling seamless integration of Chipi components into your projects.

​
Setup the Chipi MCP Server

1

Configure MCP in Cursor

Click the button below to install the Chipi MCP server in Cursor.
2

Inside your project, create a components.json file by running:

npx shadcn@latest init
3

Add chipi to the registries section in components.json

 "registries": {
 "@chipi": "https://mcp.chipipay.com/r/{name}.json"
}
4

After installation, you can ask

Once the Chipi MCP server is installed, Cursor acts as your assistant for working with Chipi. You can now:
  • 🔍 Discover what’s in the registry — “What components are available in chipiMcp list all of them”
  • 📥 Install all components and hooks into your project — “Install all components, hooks, and utilities from chipiMcp to set up a fully custom crypto-enabled app. ”
  • 🛠️ Get usage examples — “Show me how to use Chipi’s Baseprovider with Next.js.”
  • 📚 Read documentation — “What props does PayCryptoButton accept?”
  • 🧪 Debug your setup — “Check if my Chipi Pay config is correct, check if I am using and installing all correct dependecies from chipiMcp and chipi registry.json”
This means you don’t have to memorize commands or file paths — just ask Cursor, and it will fetch, install, and explain Chipi components directly in your project.

​
Troubleshooting

  • Registry not loading: Check your internet connection and registry URL.
  • Components not found: Ensure the MCP server is running.
  • Styling issues: Make sure Tailwind CSS is properly configured.
If you’re using an older version of Node.js or run into issues adding the MCP registry in Cursor settings, you can ask Cursor to fetch the registry manually by pasting this curl command into your prompt
curl -s "https://mcp.chipipay.com/r/registry.json" | jq '.items[] | {name, title, type}'
For more information about MCP Servers in Cursor, see Cursor MCP documentation.