AI tools

Cursor

Give Cursor’s agent BlueBot’s tools while you build, so it can text you when a job finishes.

What you can do

  • Have Cursor’s agent text you when a long task finishes.
  • Ask the agent why a text hasn’t gone out, and it reads the message’s hold from BlueBot.
  • Have the agent add texting to your app with BlueBot’s TypeScript or Python SDK.

How it connects

  • Recommended

    MCP

    BlueBot’s MCP server gives the assistant tools to send texts, read conversations and check your Mac.

    MCP in the docs
  • API

    Your own code calls BlueBot’s REST API and listens to its signed webhooks.

    API in the docs

Recipes

Three recipes to start from.

Set one up as written, or change it to fit how you work. The docs have the same recipes step by step.
01With MCP

Text me when the tests finish

Starts when

You ask Cursor’s agent

  1. Add BlueBot’s MCP server to Cursor with an API key as its bearer token.
  2. Ask the agent: “Run the test suite, then text me the result.”
  3. When the run ends, the agent calls send_text to your own number once you approve it.

The text it sends

Tests finished: 412 passed, 3 failed in billing.

From your own number

02With MCP

Find out why a text is waiting

Starts when

You ask Cursor’s agent

  1. Ask: “Why hasn’t the text to +15555550123 gone out?”
  2. The agent finds it with list_messages and reads its hold with get_message.
  3. It answers in words, such as “It’s waiting for quiet hours to end at 8:00 AM,” and checks get_device_status when the hold says your Mac is offline.
03With the API

Add texting to your app

Starts when

You ask Cursor’s agent to write the code

  1. Ask the agent to install bluebot from npm and send a text with POST /v1/messages.
  2. Have it pass an Idempotency-Key so a retried request never sends twice.
  3. Have it add a route that checks BlueBot’s webhook signature and handles message.received.

The text it sends

Hi {{first_name}}, your appointment on {{date}} is confirmed. Reply here if you need to change it.

From your own number

Try BlueBot free for 7 days.

You need a card to start the trial. After 7 days it’s $17.99 a month plus any tax, and you can cancel from your billing page at any time.