How to Use the Airship MCP in Cursor

Q: Can Cursor analyze my Airship segments while I write backend code?

Yes, Cursor can execute the listsegments tool to fetch your audience parameters. This lets your agent compare your local database queries against active Airship segment rules to ensure data consistency.

Q: How do I test Airship push delivery within Cursor?

Ask your agent in Cursor to call sendpushnotification with your target device token. The editor will execute the tool and display the push status response directly in the chat panel.

Q: Can I view the tags associated with a specific device?

Yes, the listtags tool retrieves all tags applied to a channel. Your agent can display these tags to help you debug conditional messaging logic.

Send Airship push notifications and debug device metadata directly inside your Cursor editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Airship MCP to Cursor

Create your Vinkius account to connect Airship to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Airship with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Send live push notifications from Cursor

The `send_push_notification` tool transmits live test alerts directly from your Cursor editor during active coding sessions. Instead of switching to a browser to test your payload formatting, your agent triggers the push and displays the API response in your side panel. You can verify the delivery success instantly using `get_push_status`. This keeps your focus on the codebase, allowing you to tweak payload structures and see the immediate results on your test device.

Inspect channel metadata while debugging

The `get_channel_details` tool pulls specific device registration data into your Cursor workspace. When you write registration logic, your agent calls this tool to verify that your local code successfully registers the device token with Airship. If the registration fails, you can run `list_channels` to see if the device appears in the global register. This direct feedback loop eliminates the need to write temporary log statements or print statements just to inspect API state.

Associate test users with this MCP Server

The `associate_named_user` tool links your test device channels to specific user profiles through this MCP Server. While writing authentication routines in Cursor, your agent runs this tool to ensure your backend database aligns with your Airship environment. You can confirm the mapping succeeded by running `list_named_users` right after. This ensures that personalization tags apply correctly to your test accounts before you deploy to production.

Setup guide

Set up Airship MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Airship MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Airship transactions." If the MCP tools are loaded correctly, Cursor will call the Airship tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "airship-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Airship. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Airship now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Airship MCP in Cursor

Create a .cursor/mcp.json file in your project root and add the Airship configuration block. Once saved, Cursor loads the tools, allowing you to use Agent mode to trigger push notifications and list channels.

Yes, Cursor can execute the `list_segments` tool to fetch your audience parameters. This lets your agent compare your local database queries against active Airship segment rules to ensure data consistency.

Ask your agent in Cursor to call `send_push_notification` with your target device token. The editor will execute the tool and display the push status response directly in the chat panel.

Yes, the `list_tags` tool retrieves all tags applied to a channel. Your agent can display these tags to help you debug conditional messaging logic.

All communication goes through secure Vinkius MCP tunnels, meaning your segment criteria and push payloads are never exposed to public logging. Your API keys remain encrypted, and data transactions occur strictly between your Cursor environment and the Airship endpoints.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript