Skip to Content
MCP IntegrationQuickstart

Quickstart

Get your AI agent connected to SharkBlock in under 5 minutes.

Prerequisites

  • A SharkBlock account with an active wallet
  • An MCP-compatible AI client (Claude Desktop, Cursor, VS Code, etc.)

1. Add the MCP Server

Claude Desktop

Open your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the SharkBlock server:

{
  "mcpServers": {
    "sharkblock": {
      "url": "https://api.alpha.sharkblock.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Cursor

Open Settings → MCP Servers → Add Server:

{
  "sharkblock": {
    "url": "https://api.alpha.sharkblock.io/mcp",
    "transport": "streamable-http"
  }
}

VS Code (GitHub Copilot)

Add to your .vscode/mcp.json:

{
  "servers": {
    "sharkblock": {
      "url": "https://api.alpha.sharkblock.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Any MCP Client

Use these connection details:

ParameterValue
Server URLhttps://api.alpha.sharkblock.io/mcp
TransportStreamable HTTP
Auth Discoveryhttps://api.alpha.sharkblock.io/.well-known/oauth-protected-resource
OpenID Confighttps://api.alpha.sharkblock.io/oauth/.well-known/openid-configuration

2. Authenticate

The first time your agent calls a SharkBlock tool, the OAuth 2.1 flow will start:

  1. Your browser opens the SharkBlock authorization page
  2. Sign in with your existing SharkBlock account (Privy — email, Google, wallet, etc.)
  3. Authorize the AI agent to access your account
  4. You’re redirected back — the agent is now connected

Authentication uses PKCE (S256) for security. Your credentials are never shared with the AI agent.

3. Start Using It

Once connected, just talk to your AI agent naturally:

Research a token:

“Look up the token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 on Solana — give me the price, security analysis, and top holders.”

Check your wallets:

“List all my SharkBlock wallets and show me the PnL for each.”

Create a strategy:

“Create a new shadow wallet and set up a trading strategy with 0.1 SOL per position, max 3 concurrent positions, with a 50% take-profit and 20% stop-loss.”

Monitor positions:

“Show me all open positions on my main strategy. Which ones are in profit?”

Discover opportunities:

“What tokens are trending right now on Solana? Show me the top 5 by volume.”

4. Test with Shadow Mode

We recommend starting with shadow mode (paper trading) to test your AI agent’s trading logic without risking real funds:

  1. Ask your agent: “Create a shadow wallet on Solana”
  2. Fund it: “Fund my shadow wallet with 5 SOL”
  3. Create a strategy: “Create a trading strategy on my shadow wallet”
  4. Start trading: “Start the strategy”
  5. Monitor: “Show me the positions and stats”

Shadow mode uses simulated transactions with the same logic as real trading — perfect for validating your AI agent’s behavior.

Troubleshooting

”Authentication failed”

  • Make sure you’re signing in with the same account you use in the SharkBlock app
  • Try revoking and re-authorizing the connection

”Tool not found”

  • Restart your MCP client to refresh the tool list
  • Verify the server URL is exactly https://api.alpha.sharkblock.io/mcp

”Rate limit exceeded”

  • SharkBlock applies per-user rate limits to MCP requests
  • Trading tools: 30 requests/minute
  • Market data: 60 requests/minute
  • Profile: 120 requests/minute
  • Wait a moment and retry

Connection issues

  • Check that your internet connection is stable
  • Verify the server is reachable: visit https://api.alpha.sharkblock.io/.well-known/oauth-protected-resource in your browser

Next Steps

Last updated on
OverviewAuthentication