How to Use the Lamha MCP in Windsurf

Q: How do I add the Lamha MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the standard config block. Alternatively, use the Settings UI under Cascade to register this MCP Server, then hit refresh to let Cascade auto-discover the eight tools.

Q: What happens if a carrier API is down during a query?

The listcarriers tool returns a clean error payload to Cascade. Windsurf then displays the failure in your chat panel, allowing you to query a different warehouse using the active MCP connection.

Run autonomous Arabic-dialect commerce tasks directly in Windsurf by chaining logistics and inventory actions.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Lamha MCP to Windsurf

Create your Vinkius account to connect Lamha to Windsurf 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 Lamha with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Middle Eastern shipping checks in Cascade

The `check_city_coverage` tool lets Cascade instantly verify delivery zones across Saudi Arabia or the UAE when a customer asks a question in a Gulf dialect. By parsing the Arabic query, Cascade extracts the city name and queries the coverage database without you writing a single line of integration code. Once coverage is confirmed, your agent uses `list_carriers` to find active shipping partners for that exact destination. Expect a fully mapped logistics path presented directly in your IDE chat in seconds.

Automate order fulfillment using the Lamha MCP Server

The `create_order` tool registers new logistics shipments directly from your Windsurf workspace when Cascade detects a purchase request. Processing the entire sequence autonomously, Cascade checks stock levels with `list_inventory` first and then immediately generates the shipment record. If a customer changes their mind, Cascade invokes `cancel_order` to stop the transit before the carrier processes the shipment. Your Arabic-first retail store keeps running without manual intervention.

Track warehouse stock and order history in Windsurf

The `list_warehouses` tool exposes your Middle Eastern storage facilities so Cascade can route regional orders to the nearest distribution center. By analyzing the customer's location, Cascade pulls warehouse data and matches it against current stock levels. When you need to resolve a dispute, Cascade uses `list_orders` and `get_order` to pull the exact customer history. You see the entire delivery timeline directly inside your workspace.

Setup guide

Set up Lamha MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Lamha MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Lamha payment history." If connected, Cascade will call the Lamha tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "lamha-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 Lamha. 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 Lamha 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 Lamha MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the standard config block. Alternatively, use the Settings UI under Cascade to register this MCP Server, then hit refresh to let Cascade auto-discover the eight tools.

Yes, Cascade chains the Arabic NLU tools autonomously. For instance, when a customer asks to cancel an item, Cascade checks the order status with `get_order` and runs `cancel_order` using the MCP integration.

Yes, the server processes Egyptian, Gulf, and Levant dialects directly. Windsurf passes the raw Arabic text from your customer interactions, and the underlying NLU maps it to structured parameters for tools like `check_city_coverage`.

The `list_carriers` tool returns a clean error payload to Cascade. Windsurf then displays the failure in your chat panel, allowing you to query a different warehouse using the active MCP connection.

All transmission of order records, warehouse locations, and carrier lists occurs within a zero-trust V8 sandbox on Vinkius. Your local environment communicates with the server via an ephemeral, authenticated connection, ensuring customer shipping addresses are never stored.

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