Skip to main content
This guide gets Cursor connected to Shuriken in about 2 minutes. Once set up, you can ask your AI to scan alpha, research tokens, check your portfolio, and trade - all from the chat panel. Time required: About 2 minutes.

​
Prerequisites

​
Step-by-step setup

1

Copy your Agent Key

If you just created your key, copy it from the setup screen. It starts with sk_.If you already closed that screen, you’ll need to create a new key - keys are only shown once.
2

Open the MCP config file

You need to edit a file called mcp.json. This is where Cursor stores its MCP server connections.Option A: Use the Command Palette (recommended)
  1. Open Cursor
  2. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
  3. Type MCP and select “Cursor Settings: Open MCP Settings”
  4. This opens your mcp.json file
Option B: Open the file manuallyThe file lives in your home directory:
C:\Users\YOUR_USERNAME\.cursor\mcp.json
Replace YOUR_USERNAME with your Windows username.
Quick way to get there: press Win+R, type %USERPROFILE%\.cursor and hit Enter. Look for mcp.json. If it doesn’t exist, create it.
3

Add the Shuriken server

Paste the following into your mcp.json file. Replace YOUR_AGENT_KEY with the key you copied in step 1.If the file is empty or doesn’t exist, paste this entire block:
mcp.json
{
  "mcpServers": {
    "shuriken": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}
If you already have other MCP servers, add the "shuriken" block inside the existing "mcpServers" object:
mcp.json
{
  "mcpServers": {
    "your-existing-server": {
      "...": "..."
    },
    "shuriken": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}
Make sure there’s a comma between each server entry. Missing commas are the most common cause of connection failures.
4

Save and restart Cursor

Save the file, then completely quit and reopen Cursor. The MCP connection won’t activate until you restart.
5

Verify the connection

Open a new chat in Cursor (the Composer or Agent panel) and try one of these prompts:
What tokens were called in my Discord today?

What's my SOL balance?
If Shuriken is connected, you’ll see the agent use Shuriken tools to answer your question. The tool names will show up in the chat (like get_recent_calls or get_balances).
If you see results, you’re all set. Your AI agent is now connected to Shuriken.

​
Troubleshooting

  • Make sure you saved the mcp.json file
  • Make sure you fully quit and restarted Cursor (not just closed the window)
  • Check that there are no syntax errors in your JSON (missing commas, extra commas, mismatched brackets)
  • Try opening the Command Palette (Ctrl+Shift+P) and searching for “MCP” - you should see Shuriken listed
  • Double-check that your Agent Key is correct (starts with sk_)
  • Make sure you included the AgentKey prefix before the key (with a space)
  • Check that the key hasn’t been revoked on the Agent Keys dashboard
Common mistakes:
  • Missing comma between server entries
  • Trailing comma after the last entry
  • Using single quotes instead of double quotes
  • Missing closing brackets
Paste your mcp.json into jsonlint.com to check for syntax errors.
The file might not exist yet. Create a new file called mcp.json in the .cursor folder inside your home directory and paste the full config block from step 3.

​
Multiple Agent Keys

You can connect multiple Shuriken Agent Keys to Cursor at the same time - for example, one read-only key for research and one with trading enabled. Give each one a different name:
mcp.json
{
  "mcpServers": {
    "shuriken-research": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey sk_YOUR_READ_ONLY_KEY"
      }
    },
    "shuriken-trading": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey sk_YOUR_TRADING_KEY"
      }
    }
  }
}
When using multiple keys, each one appears as a separate MCP server in Cursor. The AI will have access to all tools from all connected keys.