Cursor · Setup guide

AwardClaw in Cursor

Cursor reads MCP servers from mcp.json. Add AwardClaw once and the agent can pull live award space while you build trip tools, spreadsheets or alerts of your own.

Get my key Jump to setup

Included with AwardClaw Pro+. About two minutes to set up.

Set it up

1In AwardClaw (Pro+), open Agents, tap Connect an agent, pick this app and choose what it may do. Copy the key it shows.
2Open ~/.cursor/mcp.json (or .cursor/mcp.json in a project) and add the block below.
3Open Cursor Settings, then MCP, and check that awardclaw shows as connected.

~/.cursor/mcp.json

{
  "mcpServers": {
    "awardclaw": {
      "url": "https://www.awardclaw.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ac_live_YOUR_KEY"
      }
    }
  }
}

A project-level .cursor/mcp.json is shared with anyone who opens the repo. Keep your key in the global file instead.

Try asking Cursor

“Use awardclaw to fetch today's business class drops and render them as cards in this React app.”

“Check award space DFW to Doha next month and add the cheapest dates to our trip notes.”

“Write a test fixture from a real AwardClaw availability response.”

“I need two seats Miami to Buenos Aires between March 1 and 6 in business. What is open?”

What Cursor can do

search_drops

Live saver drops in business and first, ranked by quality, with open dates, miles, taxes and booking links. Defaults to your tracked cities.

search_award_space

Every open saver date on a route inside a date window, cheapest program first. The tool for "I have dates."

get_drop

Full detail for one drop, both directions.

create_trip_watch

Email alert when saver space opens on your dates.

list_trip_watches / delete_trip_watch

Manage the watches you or your agent created.

get_daily_briefing

Today's briefing: deals that expire soon, live transfer bonuses, and the top news and data points, each with why it matters.

search_points_news

Search the last 30 days of points and miles news, deals and data points on any program, card or airline.

get_card_offers

The best credit card welcome offers right now: this month's new and elevated bonuses, plus cards ranked by bonus value.

get_account

Your plan, cities and API usage today.

Read-only on award data. Cursor never sees airline logins or points balances, and every date links to the program's own site to book.

One key per tool. Revoke any key in AwardClaw and that connection stops at once.

Cursor questions

Where does my key go?+

In an Authorization: Bearer header, so it never appears in a URL or a log line. You can create a separate key for each tool and revoke any of them on its own.

Does it work in Cursor's agent and chat?+

Yes. Once the server shows as connected, the agent can call AwardClaw tools from chat and from agent runs.

Is there a rate limit?+

Pro+ includes 1,000 requests a day across all your keys. A long trip-planning chat uses a few dozen.