# deepmiro

Simulate hundreds of AI agents to predict how communities react to events and policies. Upload any document (PDF, Markdown, text) and DeepMiro spawns a diverse swarm of AI agents that debate, share, …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add kakarot-joel-yy68/deepmiro

# Browse available tools
npx -y @smithery/cli@latest tool list kakarot-joel-yy68/deepmiro

# Get full schema for a tool
npx -y @smithery/cli@latest tool get kakarot-joel-yy68/deepmiro create_simulation

# Call a tool
npx -y @smithery/cli@latest tool call kakarot-joel-yy68/deepmiro create_simulation '{}'
```

## Direct MCP Connection

Endpoint: `https://deepmiro--kakarot-joel-yy68.run.tools`

**Optional config:**
- `DEEPMIRO_API_KEY` (header) — Your DeepMiro API key (get one free at https://deepmiro.org)

## Tools (9)

- `create_simulation` — Run a full swarm prediction. Builds a knowledge graph, generates agent personas, runs a multi-agent social media simula…
- `simulation_status` — Check the progress of a running or completed simulation. Returns phase-aware status with entity names and action conten…
- `get_report` — Generate and retrieve the prediction report for a completed simulation. If the report hasn't been generated yet, trigge…
- `interview_agent` — Chat with a specific simulated agent to understand their perspective, reasoning, and predicted behavior. The agent resp…
- `list_simulations` — List past simulation runs with their status and metadata.
- `search_simulations` — Search past simulations by topic, project name, or simulation ID.
- `quick_predict` — Fast, lightweight prediction without running a full simulation. Uses the LLM to simulate swarm behavior and predict out…
- `upload_document` — Upload a document for use in simulations. LIMITS: Max 10MB, PDF/MD/TXT only. The server extracts text server-side (PyMu…
- `simulation_data` — Access raw simulation data: agent profiles, configuration, action logs, social media posts, round-by-round timeline, pe…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get kakarot-joel-yy68/deepmiro <tool-name>
```

## Resources

- `prediction://latest` — Read the latest prediction result. Server sends notifications/resources/updated when a prediction completes.