Cursor

Cursor is an AI-first IDE. Connect Handler to give Cursor's AI assistant superpowers beyond code.

Setup

Add Handler as an MCP server in your project's Cursor configuration. Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "handler": {
      "url": "https://mcp.usehandler.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk-hndlr-YOUR_KEY"
      }
    }
  }
}

Replace sk-hndlr-YOUR_KEY with the agent key from your Handler dashboard. Restart Cursor after saving the file.

What You Can Do

With Handler connected, Cursor's AI assistant can do far more than write code. Here are some real use cases:

Research while you code

// Ask Cursor:
"Search for the latest React 19 migration guide"
// Cursor calls handler_research and shows you results inline

Enrich leads from your editor

// Ask Cursor:
"Find the CTO of this company and get their email"
// Cursor calls handler_intel with person_search + person_enrich

Monitor competitors

// Ask Cursor:
"Check what people are saying about our competitor on Twitter"
// Cursor calls handler_monitor with task: "twitter"

Check financial data

// Ask Cursor:
"Get the latest stock price for AAPL and MSFT"
// Cursor calls handler_finance with task: "quote"

Generate content

// Ask Cursor:
"Draft a changelog entry for this PR using handler_generate"
// Cursor calls handler_generate to produce the content

Cursor Rules

You can add Handler instructions to your .cursor/rules directory so Cursor's AI knows how to use Handler automatically. Create a file like .cursor/rules/handler.mdc:

---
description: Handler superpowers for web search, intel, monitoring, and more
globs: **/*
alwaysApply: true
---

# Handler MCP Tools

You have access to Handler superpowers via MCP. Use them when
the user needs live data, research, or external service access.

## Available Superpowers

- handler_research: Web search, content extraction, AI answers
- handler_intel: B2B people/company data and enrichment
- handler_monitor: Social media and news monitoring
- handler_finance: Stock prices, crypto, dividends, indicators
- handler_communicate: Email via agent inbox
- handler_audio: Transcribe audio, text-to-speech
- handler_marketing: SEO, SERP tracking, Google Trends
- handler_generate: AI text generation, moderation

## Guidelines

- Call handler_status first to check capabilities and budget
- Use the task parameter for specific actions within each superpower
- Every response includes cost and remaining budget
- handler_status and handler_connections are free (no cost)