pullpush-mcp-dev

MCP server for PullPush.ai platform development — connector authoring, canonical schema management, marketplace publishing, billing, partner admin, and batch operations.

This is the developer/admin companion to kaduno-pullpush-mcp. It exposes the full tool surface including platform administration tools that require elevated API keys.

Quick Start

{
  "mcpServers": {
    "pullpush-dev": {
      "command": "npx",
      "args": ["-y", "pullpush-mcp-dev@latest"],
      "env": {
        "PULLPUSH_API_KEY": "<admin-or-org-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (Cursor) or your MCP client config.

Requires an admin or org-level API key — tenant keys will work but with limited tool access.

Environment Variables

| Variable | Required | Default | Description | | --- | --- | --- | --- | | PULLPUSH_API_KEY | Yes | — | Admin or org-level API key | | PULLPUSH_API_URL | No | https://api.pullpush.ai | API base URL |

CLI Flags

npx pullpush-mcp-dev --help      # Show usage help
npx pullpush-mcp-dev --version   # Show version

Tools Overview

Everything in kaduno-pullpush-mcp, plus:

Connector Development

• AI Generation — pullpush.connector.generate creates connector definitions from API docs
• Compose Loop — Iterative AI-driven connector refinement with test gates
• Live Test — Test connectors against real APIs in sandbox mode
• Discover Docs — AI-powered API documentation discovery

Canonical Schema Management

• Propose — Draft canonical type extensions with migration planning
• Extend — Add fields to live canonical types safely
• Activate — Promote draft schemas to active state

Marketplace

• Publish — Submit connectors to the community marketplace
• Stats — Connector install/usage analytics

Platform Admin

• Tenant Governance — Create tenants, manage registrations, approve access
• Billing — Subscriptions, usage, invoices, revenue metrics
• Partners — Partner orgs, commissions, payouts
• Backup — Configure automated backup policies and restore

Batch Operations

• preview-all — Preview sync across all active flows
• reconcile-all — Reconcile all flows in parallel
• health-matrix — Status dashboard across all connections
• pause-degraded — Auto-pause unhealthy flows

Guided Prompts

MCP prompts provide step-by-step workflows:

| Prompt | Use case | | --- | --- | | onboard-connector | Build a new connector from scratch | | extend-canonical | Add fields to a canonical type | | set-up-sync | Configure source→destination sync | | diagnose-flow | Systematic failure diagnosis | | shadow-cutover | Safely go live from shadow mode |

Which Package Do I Need?

| Package | Audience | Key | | --- | --- | --- | | kaduno-pullpush-mcp | Operators, tenants | Tenant or org key | | pullpush-mcp-dev | Developers, admins | Admin or org key |

If you only need to manage your own connections and flows, use kaduno-pullpush-mcp. If you build connectors, manage the platform, or need billing/partner tools, use this package.

Development

git clone <repo-url>
cd publish/mcp-dev
npm install
npm run dev    # Run from source via tsx
npm run build  # Compile with tsup

License

MIT