Aiqaramba MCP Server

AI-powered browser testing as an MCP tool. Give it a URL and instructions — it opens a real browser, navigates pages, fills forms, clicks buttons, and reports what it finds.

What it does

Aiqaramba runs AI agents in real browsers (Chrome, Firefox) to test web applications from an end-user perspective. No selectors, no scripts — describe what to test in plain language.

Tools

Tool	What it does	Typical time
`create_agent`	Run a targeted test — navigate to a URL, perform actions, verify outcomes	30–90s
`run_discovery`	Explore an entire site — map pages, find issues, generate test journeys	3–15min
`get_agent`	Check agent status and read results (auto-summarizes completed agents)	instant
`list_agents`	List all agents in a project	instant
`list_projects`	List available projects	instant

Example usage

"Navigate to https://mysite.com/checkout, fill the payment form with
test card 4242424242424242, click submit, and verify the confirmation
page shows an order number."

The agent opens a real browser, executes the flow, takes screenshots at each step, and returns a structured report with pass/fail status.

Setup

Connect directly to the hosted MCP endpoint. Nothing to download.

Claude Code / Cursor / VS Code:

{
  "mcpServers": {
    "aiqaramba": {
      "type": "streamable-http",
      "url": "https://mcp.aiqaramba.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Configuration

Environment variable	Default	Description
`AIQARAMBA_API_KEY`	(required)	Your API key from app.aiqaramba.com

Get an API key

Sign up at app.aiqaramba.com
Go to Settings > API Keys
Create a new key

Or book a demo to get started with a guided setup.

Requirements

URLs must be publicly reachable (not localhost). For local apps, use a tunnel like ngrok.
The agent needs to be able to navigate to the page without VPN or IP restrictions.

Terms

By using the Aiqaramba API, you agree to our Terms of Service. The API returns terms at GET /api/v1/terms and via the X-Terms-URL response header.

Aiqaramba