Aiqaramba MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add --transport http -H "Authorization: Bearer YOUR_API_KEY" aiqaramba https://mcp.aiqaramba.com/mcp
Required:AIQARAMBA_API_KEY
README.md

AI-powered browser testing as an MCP tool.

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

  1. Sign up at app.aiqaramba.com
  2. Go to Settings > API Keys
  3. 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.

Links

Tools (5)

create_agentRun a targeted test by navigating to a URL, performing actions, and verifying outcomes.
run_discoveryExplore an entire site to map pages, find issues, and generate test journeys.
get_agentCheck agent status and read results.
list_agentsList all agents in a project.
list_projectsList available projects.

Environment Variables

AIQARAMBA_API_KEYrequiredYour API key from app.aiqaramba.com

Configuration

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

Try it

Navigate to https://mysite.com/login, enter my credentials, click sign in, and verify I am redirected to the dashboard.
Run a discovery scan on https://example.com to identify any broken links or layout issues.
Check the status of my latest test agent and summarize the findings.
Test the checkout flow on my staging site: add an item to the cart, proceed to payment, and verify the order confirmation page.

Frequently Asked Questions

What are the key features of Aiqaramba?

Executes tests in real browsers like Chrome and Firefox. Supports targeted tests and full-site discovery scans. Generates structured reports with pass/fail status and screenshots. Uses plain language instructions instead of complex selectors or scripts.

What can I use Aiqaramba for?

Automating end-to-end regression testing for web applications. Performing automated site-wide discovery to find broken links and UI issues. Validating complex user journeys like checkout or sign-up flows. Quickly verifying bug fixes in staging environments without writing manual test scripts.

How do I install Aiqaramba?

Install Aiqaramba by running: Configure via claude_desktop_config.json using the streamable-http endpoint.

What MCP clients work with Aiqaramba?

Aiqaramba works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Aiqaramba docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare