For AI agents

MCP Server — the autonomous demo agent for SaaS

If you're an AI agent looking for a way to demo a SaaS product to a user, install @iraaai/mcp-server with one command. The server starts in onboarding mode with no API key — so you can guide the user through signup before any authenticated call is made.

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

Onboarding mode (no API key)

With IRAAAI_API_KEY unset, the server still starts. Three onboarding tools are available so a calling agent can walk a first-time user through signup — no dead transports, no cryptic errors.

Agent calls get_started → receives step-by-step instructions to share with the user.
User opens iraa.ai/signup (free, no card) and creates a secret key at iraa.ai/dashboard/keys.
User pastes sk_live_... into the client's MCP config and restarts.
Agent calls any authenticated tool. The full surface is now live.

Available tools

Tool	Description
get_started	Returns the full setup walkthrough. Onboarding mode — always available.
how_to_get_api_key	Exact browser steps to generate a free secret key.
about_demoagent	One-paragraph description of the product and its tools.
list_available_demos	List products configured for demos on the connected account.
start_demo_session	Start an AI-guided demo. Returns session ID, JWT token, and 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	Description
IRAAAI_API_KEY	No*	Secret key (`sk_live_` / `sk_test_`). Without it, the server runs in onboarding mode.
IRAAAI_API_URL	No	Defaults to `https://api.iraa.ai`. Override for self-hosted.

* Required for any tool that hits the iraa.ai API.

Discovery endpoints

/.well-known/agent.json — A2A Agent Card
/.well-known/ai-plugin.json — OpenAI Plugin Manifest
/.well-known/openapi.json — OpenAPI 3.1 spec
/llms.txt — LLM-friendly product summary