Metadata-Version: 2.4
Name: ymigo-mcp
Version: 1.1.2
Summary: Ymigo MCP Server — Mathematical flow coverage analysis for Claude
Project-URL: Homepage, https://ymigo.app
Project-URL: Repository, https://github.com/yakovmiler/ymigo
License: MIT
Keywords: ai,claude,coverage,flow,mcp,testing
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp[cli]>=1.0.0
Description-Content-Type: text/markdown

# ymigo-mcp

**Ymigo MCP Server** — Flow coverage analysis, test table generation, and flow management — directly inside Claude Desktop or Claude Code.

Claude is probabilistic. Ymigo is mathematical. Together they give you both.

---

## What you can do

### Analyze from a description or code
Describe your logic in plain English (or point Claude to a code file) — Claude builds the flow and runs the analysis. No manual JSON required.

> "Analyze the test coverage of my payment flow"
> "Read `src/auth/login.py` and tell me what paths aren't tested"

### Analyze flows saved in your Ymigo account
> "Analyze my Payment Flow" — Claude fetches the flow and scenarios from your account automatically.

### Save flows to Ymigo and get a visual link
After Claude builds or analyzes a flow, ask it to save it:
> "Save this flow to Ymigo so I can see it visually"

Claude creates the flow in your account and returns a direct link to open it in the browser.

### Export test tables for Jira / Confluence
> "Export the test table as CSV"

Claude returns a structured table with test cases, coverage stats, and uncovered transitions — ready to paste.

---

## Requirements

- Python 3.10+
- [Claude Desktop](https://claude.ai/download) or Claude Code

---

## Setup (5 minutes)

### 1. Install

```bash
pip install ymigo-mcp
```

### 2. Get your API key

Go to [ymigo.app](https://ymigo.app) → sign in → click your name (top right) → **Generate API Key**

You'll get a key like `ymigo_xxxxxxxxxxxxxxxx`.

### 3. Add to Claude Desktop config

Open the config file for your OS:

- **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add the following (create the file if it doesn't exist):

```json
{
  "mcpServers": {
    "ymigo": {
      "command": "ymigo-mcp",
      "env": {
        "YMIGO_API_KEY": "ymigo_xxxx"
      }
    }
  }
}
```

Replace `ymigo_xxxx` with your actual key.

### 4. Restart Claude Desktop

Fully quit Claude Desktop (including from the system tray) and reopen it.

### 5. Verify it's connected

In Claude Desktop, look for the hammer icon (Tools) at the bottom of the chat. Click it — you should see the Ymigo tools listed.

---

## Example prompts

```
"Analyze my checkout flow and tell me what's missing"
"Read src/payments/processor.py and analyze its state coverage"
"Analyze my Login Flow from Ymigo"
"What's the risk score for this flow? Explain the warnings"
"Export the test table as CSV for Jira"
"Save this flow to Ymigo so I can edit it visually"
```

---

## Tools

| Tool | What it does |
|------|-------------|
| `analyze_flow` | Full analysis — coverage %, risk score, cycles, warnings |
| `get_coverage_summary` | Short readable summary Claude explains to you |
| `export_test_table` | Test table as JSON or CSV (Jira/Confluence ready) |
| `list_my_flows` | List all flows in your Ymigo account |
| `get_my_flow` | Fetch a specific flow with its scenarios — ready for analysis |
| `create_flow_in_ymigo` | Save a flow to your Ymigo account and get a link to view it |
| `create_scenarios_in_ymigo` | Save test scenarios to a flow — view and edit them visually in Ymigo |

---

## Plans

| Plan | Flows | MCP calls |
|------|-------|-----------|
| Free | 3 | 50 / month |
| MCP Pro ($9/mo) | Unlimited | 500 / month |

Upgrade at [ymigo.app/pricing](https://ymigo.app/pricing)

---

## License

MIT
