How to Use the Alai MCP in Cursor

Q: Can I use Alai to add actual photos to the code Cursor generates?

Yes, that's the main idea. Have the agent getasset to retrieve a specific headshot's URL, then tell it to write the tag or React component to display it. You get working code with real image sources.

Q: Is it possible to manage Alai assets and campaigns from Cursor?

Absolutely. You can use tools like createasset, deleteasset, and createcampaign directly from the chat. It lets you manage the entire headshot pipeline without leaving your editor.

Write code that uses AI-generated headshots. Pull real image assets directly into 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 Alai MCP to Cursor

Create your Vinkius account to connect Alai 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 Alai with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Script Your Campaign Management

Tell your Cursor agent to script interactions with Alai. You can have it generate Python or JS code that calls `create_campaign` to start a new batch of headshots for the marketing site. The agent uses the real API response to write code that actually works. Then, extend that script to monitor progress. The agent can write a loop that periodically calls `get_campaign` and `list_generations` to check when the photos are ready. No more manually checking a web UI.

Code with Live Image Assets

This is where it gets good. Ask your agent to `list_assets` to find a specific team member's generated headshot. Cursor won't just show you the data; it will write the code to fetch and display that image on a webpage or in an app. You can build out a full gallery this way. Use `list_generations` to get all the new portraits from a run, then have the agent generate the corresponding HTML or React components. You're building with final assets, not placeholders.

Your Alai MCP Server in Cursor

This MCP Server gives your agent full control over your photo assets. You can use `create_asset` to upload a new source photo or `delete_asset` to remove an old one, all without leaving your code editor. Before you start, you can always have the agent run `check_getalai_status` to make sure the service is online. It's a simple ping that confirms your agent can talk to the Alai API.

Setup guide

Set up Alai 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 Alai 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 Alai transactions." If the MCP tools are loaded correctly, Cursor will call the Alai tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "alai-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 Alai. 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 Alai 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 Alai MCP in Cursor

Once Alai is configured, your Cursor agent can call any of its tools. You can ask it to `create_campaign` or `list_assets`, and the agent will execute the command and use the live data in its response or code generation.

Yes, that's the main idea. Have the agent `get_asset` to retrieve a specific headshot's URL, then tell it to write the `` tag or React component to display it. You get working code with real image sources.

Absolutely. You can use tools like `create_asset`, `delete_asset`, and `create_campaign` directly from the chat. It lets you manage the entire headshot pipeline without leaving your editor.

Templates are the different visual styles Alai can apply to your photos. You can see what's available by having your agent call the `list_templates` tool.

Alai only handles the selfies you explicitly upload via the `create_asset` tool. All data is sent over a secure connection to the Vinkius-managed server. The server environment is isolated and doesn't persist your photo data beyond the immediate task.

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