syntaro

Files (1)

• SKILL.md

SKILL.md (first lines)

# SYNTARO Skill — SYNTARO

SYNTARO is a GitHub bot that takes issue descriptions, investigates your codebase, writes a fix, runs tests, and opens a PR. Agents access SYNTARO through its MCP (Model Context Protocol) API.

## Quick Install

### OpenCode
Add to `opencode.json`:
```json
{
  "mcpServers": {
    "syntaro": {
      "command": "python3",
      "args": ["-m", "syntaro_mcp.server", "stdio"]
    }
  }
}
```

Or run:
```bash
bash syntaro_mcp/install.sh --opencode
```

### Claude Code
```bash
npx syntaro install-mcp --claude
```

### Cursor
1. Open Cursor Settings → Features → MCP Servers
2. Click **+ Add New MCP Server**
3. Name: `syntaro`, Type: `command`, Command: `python3 -m syntaro_mcp.server stdio`

### Codex CLI
Add to `.codex/config.json`:
```json
{
  "mcpServers": {
    "syntaro": {
      "command": "python3",
      "args": ["-m", "syntaro_mcp.server", "stdio"]
    }
  }
}
```

## Tools

### submit_issue

Submit a new issue fix request to SYNTARO. This triggers the full pipeline: investigation → fix → test → PR.

**HTTP:** `POST /mcp/submit_issue`

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `repoOwner` | string | ✅ | GitHub repository owner (user or org) |
| `repoName` | string | ✅ | GitHub repository name |
| `issueTitle` | string | ✅ | Issue title (max 500 chars) |
| `issueBody` | string | ✅ | Issue description (max 50,000 chars) |
| `labels` | string[] | ❌ | Labels to apply to the issue |
| `channel` | enum | ❌ | Notification channel: `slack`, `telegram`, `whatsapp` |
| `channelTarget` | string | ❌ | Channel-specific target ID |

**Example:**

```json
{
  "repoOwner": "my-org",
  "repoName": "my-repo",
  "issueTitle": "Login form returns 500 on special chars",
  "issueBody": "When email contains '+' or '&', the login endpoint crashes with a 500 error.",
  "labels": ["bug", "high-priority"]
}
```

**Response:**

```json
{
  "runId": "syntaro-a1b2c3d4e5f6",
  "status": "accepted",
  "pollUrl": "https://api.syntaro.io/mcp/status/syntaro-a1b2c3d4e5f6",
  "createdAt": "2026-07-17T10:30:00Z"
}
```

**Error Responses:**

| Code | Meaning |
|------|---------|
| 400 | Missing required fields or field length exceeded |
| 401 | Missing or invalid `Authorization` header |
| 429 | Rate limit exceeded — retry after `Retry-After` header |
| 500 | Internal pipeline error |

---

### check_status

Poll the current status of a fix run.

**HTTP:** `GET /mcp/status/:runId`

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `runId` | string | ✅ | Run ID returned by `submit_issue` |

**Response:**

```json
{
  "runId": "syntaro-a1b2c3d4e5f6",
  "status": "investigating",

From Aimino-Tech/syntaro-mcp, AGPL-3.0.

More from Aimino-Tech/syntaro-mcp