@iraaai/mcp-server

Autonomous demo agent for SaaS products. MCP server that lets Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI agent discover, integrate, and run live AI-guided product demos by DemoAgent.

If you're an AI agent (or you're a developer reading this through one), this server is built for you. Install it with one command and walk the user through generating an API key — the server starts in onboarding mode and tells you exactly what to do.

One-line install

Claude Code

claude mcp add iraaai -- npx -y @iraaai/mcp-server

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "iraaai": {
      "command": "npx",
      "args": ["-y", "@iraaai/mcp-server"],
      "env": { "IRAAAI_API_KEY": "sk_live_..." }
    }
  }
}

Cursor / Windsurf — same JSON, in their respective MCP config files.

Smithery

npx -y @smithery/cli install @iraaai/mcp-server --client claude

Two modes

Authenticated mode

Set IRAAAI_API_KEY=sk_live_... and the full tool surface is available.

Onboarding mode (no API key)

The server still starts. Three onboarding tools are available:

• get_started — full setup walkthrough
• how_to_get_api_key — exact browser steps to generate a secret key
• about_demoagent — short product description

Any authenticated tool, when called without a key, returns a structured "needs auth" message pointing to the signup flow. The agent can guide the user through signup without ever seeing a dead transport.

Tools (authenticated)

| Tool | Description | |------|-------------| | list_available_demos | List all products configured for demos on the connected account | | start_demo_session | Start an AI-guided demo (returns session ID, JWT token, greeting) | | send_demo_message | Send a visitor message to an active session, get the agent reply | | capture_lead | Record email / name / company / phone for a session | | create_demo_link | Generate a pre-seeded shareable demo URL for a prospect | | run_headless_demo | Run a full demo programmatically — get transcript + lead signals |

Environment

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | IRAAAI_API_KEY | No* | – | Secret key (sk_live_* or sk_test_*). Without it the server runs in onboarding mode. | | IRAAAI_API_URL | No | https://api.iraa.ai | API base — override for self-hosted instances. |

* Required for any tool that hits the iraa.ai API. Onboarding tools work without it.

Get an API key

1. Sign up at https://iraa.ai/signup (free, no card).
2. Open https://iraa.ai/dashboard/keys.
3. Click Create secret key, label it (e.g. "Claude Code"), pick Server / Agent.
4. Copy the sk_live_... value — it's only shown once.

What is DemoAgent?

DemoAgent by iraa.ai is an autonomous AI agent that runs live, conversational product demos on SaaS websites. It navigates the real product in an iframe (not a video), answers questions, and captures leads. Multi-agent system (Router → Demo / Q&A / Discovery / Docs), powered by Claude.

Discovery endpoints

• A2A Agent Card: https://api.iraa.ai/.well-known/agent.json
• OpenAI Plugin: https://api.iraa.ai/.well-known/ai-plugin.json
• OpenAPI 3.1: https://api.iraa.ai/.well-known/openapi.json
• LLM docs: https://iraa.ai/llms.txt

Links

• Docs: https://iraa.ai/docs
• Dashboard: https://iraa.ai/dashboard
• npm: https://www.npmjs.com/package/@iraaai/mcp-server

MIT — © iraa.ai