Add mcp-a2a-gateway config and seed script

Replace a2a-mcp-bridge (hardcoded 30s timeout) with mcp-a2a-gateway
which supports configurable timeouts (set to 300s) and persistent
agent registrations. Includes a seed script to pre-register all
5 provider agents from the HF Space deployment.

Made-with: Cursor

.cursor/mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "fireaction": {
+      "command": "uvx",
+      "args": ["mcp-a2a-gateway"],
+      "env": {
+        "MCP_REQUEST_TIMEOUT": "300",
+        "MCP_DATA_DIR": "~/.cursor/fireaction-gateway-data",
+        "LOG_LEVEL": "INFO"
+      }
+    }
+  }
+}

README.md

@@ -40,6 +40,68 @@ Each provider agent exposes three internal tools to an LLM planner:
 The planner runs a ReAct loop: search for contracts, inspect their schemas,
 generate instance nodes, execute, and feed results back for multi-step tasks.
 
+## MCP setup (Cursor / Claude Code / VS Code Copilot)
+
+The agents can be used from any MCP-compatible client via
+[`mcp-a2a-gateway`](https://pypi.org/project/mcp-a2a-gateway/), a Python-based
+MCP↔A2A bridge with configurable timeouts and persistent agent registrations.
+
+### 1. Add the MCP server
+
+The repo ships a `.cursor/mcp.json` that Cursor picks up automatically.
+For other clients, add the equivalent config:
+
+```json
+{
+  "mcpServers": {
+    "fireaction": {
+      "command": "uvx",
+      "args": ["mcp-a2a-gateway"],
+      "env": {
+        "MCP_REQUEST_TIMEOUT": "300",
+        "MCP_DATA_DIR": "~/.cursor/fireaction-gateway-data",
+        "LOG_LEVEL": "INFO"
+      }
+    }
+  }
+}
+```
+
+### 2. Register the agents
+
+**Option A** — Run the seed script (pre-registers all agents in one step):
+
+```bash
+python scripts/seed_gateway.py
+```
+
+This fetches agent cards from the HF Space deployment and writes them to the
+gateway's data directory. Registrations persist across restarts.
+
+**Option B** — Register interactively from your MCP client:
+
+Ask the AI to run `register_agent` for each provider URL:
+
+```
+https://zequn-fireworks-fireaction-a2a.hf.space/resend/
+https://zequn-fireworks-fireaction-a2a.hf.space/discord/
+https://zequn-fireworks-fireaction-a2a.hf.space/github/
+https://zequn-fireworks-fireaction-a2a.hf.space/plaid/
+https://zequn-fireworks-fireaction-a2a.hf.space/square/
+```
+
+### 3. Use the agents
+
+Once registered, the gateway exposes these MCP tools:
+
+| Tool | Purpose |
+|---|---|
+| `send_message` | Send a task to an agent and get a response |
+| `get_task_result` | Poll for completion of a long-running task |
+| `get_task_list` | List all tasks and their statuses |
+| `list_agents` | Show all registered agents |
+| `register_agent` / `unregister_agent` | Add or remove agents dynamically |
+
 ## Configuration
 
 All via environment variables:

scripts/seed_gateway.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""Pre-register fireaction A2A agents with mcp-a2a-gateway.
+
+Fetches agent cards from the deployed HF Space and writes them to the
+gateway's data directory so they're available immediately on first launch
+(no manual ``register_agent`` calls needed).
+
+Usage:
+    python scripts/seed_gateway.py                     # defaults
+    python scripts/seed_gateway.py --base-url http://localhost:7860
+    python scripts/seed_gateway.py --providers resend discord
+    python scripts/seed_gateway.py --data-dir /custom/path
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+import httpx
+
+DEFAULT_BASE_URL = "https://zequn-fireworks-fireaction-a2a.hf.space"
+DEFAULT_PROVIDERS = ["resend", "discord", "github", "plaid", "square"]
+DEFAULT_DATA_DIR = "~/.cursor/fireaction-gateway-data"
+
+REGISTERED_AGENTS_FILE = "registered_agents.json"
+
+
+def fetch_agent_card(client: httpx.Client, agent_url: str) -> dict:
+    """Fetch the .well-known/agent.json card from an A2A agent."""
+    card_url = agent_url.rstrip("/") + "/.well-known/agent.json"
+    resp = client.get(card_url, follow_redirects=True)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Seed mcp-a2a-gateway with fireaction agents")
+    parser.add_argument(
+        "--base-url",
+        default=os.environ.get("FIREACTION_BASE_URL", DEFAULT_BASE_URL),
+        help=f"Base URL of the fireaction-a2a deployment (default: {DEFAULT_BASE_URL})",
+    )
+    parser.add_argument(
+        "--providers",
+        nargs="+",
+        default=DEFAULT_PROVIDERS,
+        help=f"Provider names to register (default: {' '.join(DEFAULT_PROVIDERS)})",
+    )
+    parser.add_argument(
+        "--data-dir",
+        default=os.environ.get("MCP_DATA_DIR", DEFAULT_DATA_DIR),
+        help=f"Gateway data directory (default: {DEFAULT_DATA_DIR})",
+    )
+    parser.add_argument(
+        "--timeout",
+        type=int,
+        default=30,
+        help="HTTP timeout in seconds for fetching agent cards (default: 30)",
+    )
+    args = parser.parse_args()
+
+    data_dir = Path(os.path.expanduser(args.data_dir))
+    data_dir.mkdir(parents=True, exist_ok=True)
+    agents_file = data_dir / REGISTERED_AGENTS_FILE
+
+    existing: dict = {}
+    if agents_file.exists():
+        existing = json.loads(agents_file.read_text())
+        print(f"Loaded {len(existing)} existing agent(s) from {agents_file}")
+
+    agent_urls = [f"{args.base_url.rstrip('/')}/{p}/" for p in args.providers]
+    registered = dict(existing)
+
+    with httpx.Client(timeout=args.timeout) as client:
+        for url in agent_urls:
+            try:
+                card = fetch_agent_card(client, url)
+                registered[url] = {"card": card}
+                print(f"  OK  {card.get('name', url)}")
+            except httpx.HTTPStatusError as e:
+                print(f"  FAIL {url} — HTTP {e.response.status_code}", file=sys.stderr)
+            except httpx.ConnectError:
+                print(f"  FAIL {url} — connection refused (is the server running?)", file=sys.stderr)
+            except Exception as e:
+                print(f"  FAIL {url} — {e}", file=sys.stderr)
+
+    agents_file.write_text(json.dumps(registered, indent=4))
+    print(f"\nWrote {len(registered)} agent(s) to {agents_file}")
+
+
+if __name__ == "__main__":
+    main()