diff --git a/README.md b/README.md
index 146863e..39339fe 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# AI Coding Tookit for Plaid
+# AI Coding Toolkit for Plaid
A toolkit designed to accelerate Plaid integration development using AI coding assistants. This repository provides local MCP tools (mock data generation, documentation search capabilities, etc.) and product-specific guides to help developers build Plaid integrations faster and more efficiently with AI assistance.
@@ -13,48 +13,31 @@ The AI toolkit is part of a suite of tools to accelerate AI-powered development.
## Repository Structure
- `/sandbox`: Contains a sandbox MCP server implementation that helps developers integrate with Plaid more quickly by providing mock data and sandbox API access.
-- `/rules`: Contains product-specific guides that can be used either as direct prompts for AI assistants or as Cursor rules to accelerate Plaid integration development.
+- `/rules`: Contains product-specific guides that can be used as instructions for AI coding assistants to accelerate Plaid integration development.
## Sandbox MCP Server
-The sandbox MCP server located in `/sandbox` directory provides a set of tools to facilitate faster integration with Plaid. It offers:
-
-- Mock financial data generation
-- Plaid documentation search
-- Sandbox API access tokens
-- Webhook simulation
-
-This sandbox environment allows developers to test their Plaid integrations without using real financial data.
-
-### Key Features
+The sandbox MCP server in `/sandbox` provides tools to test Plaid integrations without using real financial data:
- **Generate mock financial data** for testing purposes
- **Search Plaid documentation** for relevant API information
- **Obtain sandbox access tokens** for testing
- **Simulate webhooks** to test application handling
-### Getting Started
-
-To use the sandbox MCP server, navigate to the `/sandbox` directory and follow the instructions in its README.
-
-```bash
-cd sandbox
-# Follow instructions in sandbox/README.md for setup and usage
-```
+See [sandbox/README.md](sandbox/README.md) for setup instructions across Claude Code, Cursor, Codex, VS Code, Claude Desktop, and Zed.
## Rules for AI Integration
-The `/rules` directory contains comprehensive guides for various Plaid products and features. These guides can be used in two ways:
-
-1. **Direct Prompts**: Copy the content directly into your conversations with AI assistants to provide them with specialized knowledge about Plaid products.
+The `/rules` directory contains product-specific guides for Plaid integrations. You can use them in two ways:
-2. **Cursor Rules**: Import them as Cursor rules to enable your AI coding assistant to automatically understand Plaid's integration patterns and best practices.
+1. **Project instructions**: Drop the content into your AI tool's instructions file (`CLAUDE.md` for Claude Code, `AGENTS.md` for Codex, Cursor rules, etc.) so the assistant has the context automatically.
+2. **Direct prompts**: Paste the content directly into a conversation with your AI assistant.
Using these rules significantly accelerates development by giving AI models the context they need to generate code for Plaid integrations.
> [!WARNING]
-These guides are designed to be used for the purpose of building a sample Plaid integration with the use of AI coding tools. You are solely responsible for ensuring the correctness, legality, security, privacy, and compliance of your own app and Plaid integration. This guide is provided under the MIT license and is provided as-is and without warranty of any kind.
+> These guides are designed to be used for the purpose of building a sample Plaid integration with the use of AI coding tools. You are solely responsible for ensuring the correctness, legality, security, privacy, and compliance of your own app and Plaid integration. This guide is provided under the MIT license and is provided as-is and without warranty of any kind.
## License
-This project is licensed under the MIT License - see the LICENSE file for details.
+This project is licensed under the MIT License - see the LICENSE file for details.
diff --git a/sandbox/README.md b/sandbox/README.md
index c1527c2..4b180db 100644
--- a/sandbox/README.md
+++ b/sandbox/README.md
@@ -28,22 +28,17 @@ A Model Context Protocol server for facilitating integration with Plaid. This se
1. Sign in to your [Plaid Developer Dashboard](https://developer.plaid.com) account
2. Navigate to **Developers** → **[Keys](https://dashboard.plaid.com/developers/keys)**
-3. Locate your **sandbox credentials** as illustrated in the screenshot below.
+3. Locate your **sandbox credentials**.
->[!Important]
-All `PLAID_CLIENT_ID` and `PLAID_SECRET` references in the following MCP configuration use **sandbox credentials**.
+> [!IMPORTANT]
+> All `PLAID_CLIENT_ID` and `PLAID_SECRET` references in the following MCP configuration use **sandbox credentials**.
+> [!NOTE]
+> All snippets below use `uvx`. If you installed via pip, swap `uvx mcp-server-plaid` for `python -m mcp_server_plaid`.
-
+### Usage with Claude Code
-
-
-### Usage with Claude Desktop
-
-Add this to your `claude_desktop_config.json`:
-
-
-Using uvx
+Add this to `.mcp.json` in your project root (or `~/.claude.json` for a user-scoped install):
```json
{
@@ -61,34 +56,20 @@ Add this to your `claude_desktop_config.json`:
}
}
```
-
-
-Using pip installation
+Or use the CLI:
-```json
-{
- "mcpServers": {
- "plaid": {
- "command": "python",
- "args": [
- "-m",
- "mcp_server_plaid",
- "--client-id",
- "YOUR_PLAID_CLIENT_ID",
- "--secret",
- "YOUR_PLAID_SECRET"
- ]
- }
- }
-}
+```bash
+claude mcp add plaid -- uvx mcp-server-plaid --client-id YOUR_PLAID_CLIENT_ID --secret YOUR_PLAID_SECRET
```
-
### Usage with Cursor
-For manual installation, add the following JSON block to Cursor MCP config file,
-
-Using uvx
+
+For quick installation, use the one-click installation button.
+
+[](https://cursor.com/install-mcp?name=plaid&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItcGxhaWQiLCJlbnYiOnsiUExBSURfQ0xJRU5UX0lEIjoiQUREX1lPVVJfQ0xJRU5UX0lEIiwiUExBSURfU0VDUkVUIjoiQUREX1lPVVJfQVBJX1NFQ1JFVCJ9fQ%3D%3D)
+
+For manual installation, add the following JSON block to Cursor MCP config file.
```json
{
@@ -106,33 +87,20 @@ For manual installation, add the following JSON block to Cursor MCP config file,
}
}
```
-
-
-Using pip installation
+### Usage with Codex
-```json
-{
- "mcpServers": {
- "plaid": {
- "command": "python",
- "args": [
- "-m",
- "mcp_server_plaid",
- "--client-id",
- "YOUR_PLAID_CLIENT_ID",
- "--secret",
- "YOUR_PLAID_SECRET"
- ]
- }
- }
-}
+Add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.plaid]
+command = "uvx"
+args = ["mcp-server-plaid", "--client-id", "YOUR_PLAID_CLIENT_ID", "--secret", "YOUR_PLAID_SECRET"]
```
-
### Usage with VS Code
-For quick installation, use one of the one-click installation buttons below,
+For quick installation, use one of the one-click installation buttons below.
[](https://insiders.vscode.dev/redirect/mcp/install?name=plaid&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22client_id%22%2C%22description%22%3A%22Plaid%20Client%20ID%22%2C%22password%22%3Afalse%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22secret%22%2C%22description%22%3A%22Plaid%20Secret%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-plaid%22%5D%2C%22env%22%3A%7B%22PLAID_CLIENT_ID%22%3A%22%24%7Binput%3Aclient_id%7D%22%2C%22PLAID_SECRET%22%3A%22%24%7Binput%3Asecret%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=plaid&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22client_id%22%2C%22description%22%3A%22Plaid%20Client%20ID%22%2C%22password%22%3Afalse%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22secret%22%2C%22description%22%3A%22Plaid%20Secret%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-plaid%22%5D%2C%22env%22%3A%7B%22PLAID_CLIENT_ID%22%3A%22%24%7Binput%3Aclient_id%7D%22%2C%22PLAID_SECRET%22%3A%22%24%7Binput%3Asecret%7D%22%7D%7D&quality=insiders)
@@ -142,9 +110,6 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is needed when using the `mcp.json` file.
-
-Using uvx
-
```json
{
"mcp": {
@@ -175,14 +140,31 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
}
}
```
-
-### Usage with [Zed](https://github.com/zed-industries/zed)
+### Usage with Claude Desktop
-Add to your Zed settings.json:
+Add this to your `claude_desktop_config.json`:
-
-Using uvx
+```json
+{
+ "mcpServers": {
+ "plaid": {
+ "command": "uvx",
+ "args": [
+ "mcp-server-plaid",
+ "--client-id",
+ "YOUR_PLAID_CLIENT_ID",
+ "--secret",
+ "YOUR_PLAID_SECRET"
+ ]
+ }
+ }
+}
+```
+
+### Usage with Zed
+
+Add to your Zed `settings.json`:
```json
{
@@ -202,29 +184,6 @@ Add to your Zed settings.json:
}
}
```
-
-
-
-Using pip installation
-
-```json
-{
- "context_servers": {
- "mcp-server-plaid": {
- "command": "python",
- "args": [
- "-m",
- "mcp_server_plaid",
- "--client-id",
- "YOUR_PLAID_CLIENT_ID",
- "--secret",
- "YOUR_PLAID_SECRET"
- ]
- }
- }
-}
-```
-
## Debugging