npm package: @first-to-fly/orchestrator-mcp-admin
Description: Admin MCP server for FirstToFly Orchestrator - manage agents, knowledge, and work queues
Latest version: 0.3.1

# @first-to-fly/orchestrator-mcp-admin

Admin MCP server for managing knowledge, work queues, and auditing the orchestrator. This is the companion to [`@first-to-fly/orchestrator-mcp`](../mcp-server) — use that package for daily agent tools.

## When to use

- **Scaffolding**: Auto-generate entities from codebase structure
- **Bulk operations**: Seed knowledge with up to 50 entities at once
- **Queue management**: Create work items and monitor queue status
- **Cleanup**: Prune stale entities, detect near-duplicates
- **Auditing**: Search session history, view entity version history

## Quick Start

If you've already set up the agent MCP, the admin MCP reuses the same credentials.

```bash
npx @first-to-fly/orchestrator-mcp-admin@latest init
```

Or add manually to `.mcp.json`:

```json
{
  "mcpServers": {
    "orchestrator-admin": {
      "command": "npx",
      "args": ["-y", "@first-to-fly/orchestrator-mcp-admin@latest"],
      "env": {
        "ORCHESTRATOR_API_URL": "https://orchestrator.firsttofly.com/api/v1",
        "ORCHESTRATOR_API_KEY": "ftfo_your_key_here",
        "ORCHESTRATOR_PROJECT": "your-project-slug"
      }
    }
  }
}
```

## Admin Tools (11)

### Queue

| Tool               | What it does                                      |
| ------------------ | ------------------------------------------------- |
| `create_work_item` | Create a work item (single or array via `items`). |
| `list_work_items`  | List work items, optionally filtered by status.   |

### Knowledge

| Tool               | What it does                                                                                   |
| ------------------ | ---------------------------------------------------------------------------------------------- |
| `scaffold_project` | Auto-generate entities from codebase structure. Safe to re-run.                                |
| `store_entity`     | Store entities (single or array via `entities`, max 50). Deduplicates by type+name.            |
| `delete_entity`    | Delete entities (single or array via `entities`). Dry run by default, requires human approval. |
| `prune_stale`      | Remove stale entities older than a threshold. Dry run by default.                              |
| `find_similar`     | Detect near-duplicate entities by content similarity.                                          |

### Audit

| Tool              | What it does                                                        |
| ----------------- | ------------------------------------------------------------------- |
| `search_sessions` | Search across past session summaries by keyword.                    |
| `entity_version`  | View version history of an entity, or a specific version's content. |
| `check_approval`  | Check the status of a pending approval request.                     |

### Analytics

| Tool                  | What it does                                         |
| --------------------- | ---------------------------------------------------- |
| `report_session_cost` | Report token usage and cost for the current session. |

## Environment Variables

| Variable               | Description                                                      | Required |
| ---------------------- | ---------------------------------------------------------------- | -------- |
| `ORCHESTRATOR_API_URL` | API endpoint (e.g. `https://orchestrator.firsttofly.com/api/v1`) | Yes      |
| `ORCHESTRATOR_API_KEY` | Project API key (starts with `ftfo_`)                            | Yes      |
| `ORCHESTRATOR_PROJECT` | Project slug                                                     | Yes      |

## Links

- [Agent MCP](../mcp-server) — 12 tools for daily agent use
- [Web App](https://orchestrator.firsttofly.com)
- [GitHub](https://github.com/first-to-fly/firsttofly-orchestrator)