@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 — 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.

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

Or add manually to .mcp.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 — 12 tools for daily agent use
• Web App
• GitHub