# pullpush-mcp [Health: Active] **Category:** πŸ—„οΈ Databases **Repository:** https://github.com/Kaduno-systems/pullpush-mcp **GitHub Stars:** 0 **npm Downloads (last month):** 177 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/pullpush-mcp ## Description Connect any two APIs and keep them in sync β€” 45 MCP tools with shadow previews and diagnostics. ## Tools Capabilities this server exposes over MCP: - **pullpush.connection.create** β€” Create and configure a connection to an external system (Shopify, WooCommerce, Linnworks, Xero, HubSpot, and 20+ more) - **pullpush.connection.test** β€” Test live connection credentials; returns health metrics and failure count - **pullpush.connection** β€” List, get, update, delete, and configure connections (router with actions: list, get, update, delete, health, config) - **pullpush.flow.create** β€” Wire a sourceβ†’destination sync pipeline with triggers, mapping, and canonical data models - **pullpush.flow.dryRun** β€” Dry-run an event through flow transform/filter without delivery; returns mapped payload - **pullpush.flow.natural** β€” Create a flow from a natural-language description; proposes mapping and creates in shadow mode - **pullpush.flow** β€” List, get, update, pause/resume, delete flows and view delivery history (router) - **pullpush.sync.reconcile** β€” Reconcile-and-deliver: diff source vs destination, then deliver changes with per-item progress - **pullpush.sync** β€” Preview diffs, snapshot data, inspect single keys, scan catalogs, diagnose unmatched SKUs, manage baselines (router with actions: preview, snapshot, inspect, reconcile, scan, reset-baseline, baseline.history, baseline.rollback, channel-cache, unmatched) - **pullpush.mapping.suggest** β€” AI-proposes field mapping from source sample to target shape; returns mapping, confidence, preview - **pullpush.mapping.validate** β€” Validate a mapping config against source and destination schemas - **pullpush.mapping.compare** β€” Compare two mappings side by side - **pullpush.mapping.explain** β€” Explain how a mapping transforms data, step by step - **pullpush.mapping.diff** β€” Diff two mapping versions to see what changed - **pullpush.mapping.get** β€” Get a flow's current mapping config, source fields, and destination fields - **pullpush.explain** β€” Diagnose why a flow, connection, or delivery failed; gathers errors, identifies patterns, suggests fixes - **pullpush.diagnose.recent** β€” Scan all flows for recent failures; returns a prioritized issue list - **pullpush.ask** β€” Answer natural-language ops questions using tenant failures and anomalies - **pullpush.connector.generate** β€” AI-generates TypeScript connector code, typechecks, tests, and registers - **pullpush.connector** β€” List, get, update, and manage connector definitions (router) - **pullpush.data.push** β€” Push file data (CSV, JSON, XML) into a connection - **pullpush.import** β€” File-based data import operations (router) - **pullpush.export** β€” Scheduled export pipelines: create, list, update, delete, test, run (router) - **pullpush.canonical** β€” Inspect and manage canonical data models (router) - **pullpush.shadow** β€” Run integrations read-only before going live; compare shadow vs live results (router) - **pullpush.batch.test** β€” Test multiple connections in parallel - **pullpush.batch.status** β€” Get status matrix across all flows - **pullpush.batch.setup** β€” One-call setup: create connections + flow + test in one operation - **pullpush.batch** β€” Multi-flow batch operations and proactive reports (router) - **pullpush.health.overview** β€” Tenant health dashboard: connections, flows, failures, backlog, delivery rate, anomalies - **pullpush.health.mcp** β€” MCP server health: database, tools registered, uptime - **pullpush.ops** β€” Anomaly detection, dead-letter recovery, operation monitoring (router) - **pullpush.workflow.create** β€” Create multi-step workflow with trigger and step DAG - **pullpush.workflow.trigger** β€” Manually trigger a workflow run from an existing event - **pullpush.workflow** β€” List, get, and manage workflows (router) - **pullpush.integration.create** β€” Create an integration grouping flows/workflows under one name - **pullpush.integration** β€” List and manage integrations (router) - **pullpush.marketplace.install** β€” Install a marketplace listing into your tenant - **pullpush.marketplace** β€” Browse and manage marketplace connectors (router) - **pullpush.destination.provision** β€” Provision custom fields on destination API (e.g. HubSpot properties) - **pullpush.tenant** β€” Tenant management: list, get, create, update (router) - **pullpush.billing** β€” Subscription and usage management (router) - **pullpush.partner** β€” Partner program operations (router) - **pullpush.backup** β€” Backup and restore operations (router) - **pullpush.feedback** β€” Submit feedback about MCP tool quality or missing features ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "pullpush-mcp": { "command": "npx", "args": ["-y","kaduno-pullpush-mcp@latest"] } } ``` ## Documentation & README # PullPush MCP β€” connect any two APIs and keep them in sync [![npm](https://img.shields.io/npm/v/kaduno-pullpush-mcp)](https://www.npmjs.com/package/kaduno-pullpush-mcp) [![MCP Registry](https://img.shields.io/badge/MCP%20registry-ai.pullpush%2Fpullpush--mcp-a855f7)](https://registry.modelcontextprotocol.io/v0/servers?search=ai.pullpush/pullpush-mcp) [![license](https://img.shields.io/badge/license-MIT-22c55e)](./LICENSE) The official MCP server for [PullPush.ai](https://pullpush.ai) β€” an integration platform that connects e-commerce stores, warehouses, marketplaces, ERPs, and POS systems, and keeps stock levels, orders, and products in sync across all of them. This server lets AI agents (Claude, Cursor, or anything that speaks [Model Context Protocol](https://modelcontextprotocol.io)) build, run, and monitor those integrations end to end: connect two systems, preview the sync safely, and cut over to live β€” without a human clicking through a dashboard. ## Why agents like it - **Deterministic runtime, no LLM in the hot path.** AI helps at build time (connector generation, field-mapping suggestions); the sync engine itself is predictable, versioned, and observable. - **Safe by default.** New flows start in **shadow mode** (read-only). `pullpush.sync` `action:"preview"` shows a structured source-vs-destination diff before anything is written. - **Credentials never touch your machine or env.** Connection secrets are envelope-encrypted (AES-256-GCM, per-tenant keys) server-side the moment they're created. - **Self-describing.** A `get-started` MCP prompt walks from zero to a working integration; `pullpush://` resources expose the tool catalog, quickstart, and agent guide β€” no pre-briefing needed. - **Structured, actionable errors.** Failures return `{code, suggestion, suggestedTool, retryable}` β€” an agent always knows the next step. - **Server-grade reliability.** Circuit breakers, per-key ordered delivery, idempotency, dead-letter queue with retry, exponential backoff. ## Try it in 60 seconds β€” no signup ```bash curl -X POST https://api.pullpush.ai/api/sandbox ``` Returns a free 48-hour sandbox tenant: an API key, ready-to-paste MCP configs, and two pre-wired demo connections whose stock data deliberately disagrees β€” so your first `pullpush.sync` `action:"preview"` shows a real canonical diff (drifted quantities, a missing item, in-sync rows). The sandbox deletes itself on expiry β€” or keep it: `POST /api/sandbox/claim` (Bearer = the sandbox key, `{"email": "..."}`) converts it to a persistent free tenant with everything you built preserved. ## Quick start No clone or install needed β€” run directly via `npx`: ```json { "mcpServers": { "pullpush": { "command": "npx", "args": ["-y", "kaduno-pullpush-mcp@latest"], "env": { "PULLPUSH_API_KEY": "" } } } } ``` Add this to `~/.cursor/mcp.json` (Cursor), Claude Desktop's config, or the MCP config for your client. Prefer a remote server? Connect straight to the hosted endpoint instead: ```json { "mcpServers": { "pullpush": { "type": "streamable-http", "url": "https://api.pullpush.ai/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Then ask your agent to run the **`get-started`** prompt β€” it walks through the whole flow: catalog connectors β†’ create + test connections β†’ suggest a field mapping β†’ create the flow in shadow mode β†’ preview the diff β†’ cut over. ## Getting an API key For a throwaway key, use the sandbox above. For a persistent tenant: 1. [Sign up free](https://app.pullpush.ai/sign-up) (1 connection, 1,000 events/month β€” no card) 2. Admin panel β†’ **Settings β†’ API Keys** 3. Create a key with the scope you need (tenant, org, or admin) ## Tools **48 tools** (**30 explicit tools** plus **184 actions** across 18 domain routers) covering the full integration lifecycle. Explicit tools are individually named; domain routers accept an `action` parameter with multiple operations. ### Connections - `pullpush.connection.create` β€” Create and configure a connection to an external system (Shopify, WooCommerce, Linnworks, Xero, HubSpot, and 20+ more) - `pullpush.connection.test` β€” Test live connection credentials; returns health metrics and failure count - `pullpush.connection` β€” List, get, update, delete, and configure connections (router with actions: list, get, update, delete, health, config) ### Flows - `pullpush.flow.create` β€” Wire a sourceβ†’destination sync pipeline with triggers, mapping, and canonical data models - `pullpush.flow.dryRun` β€” Dry-run an event through flow transform/filter without delivery; returns mapped payload - `pullpush.flow.natural` β€” Create a flow from a natural-language description; proposes mapping and creates in shadow mode - `pullpush.flow` β€” List, get, update, pause/resume, delete flows and view delivery history (router) ### Sync & reconciliation - `pullpush.sync.reconcile` β€” Reconcile-and-deliver: diff source vs destination, then deliver changes with per-item progress - `pullpush.sync` β€” Preview diffs, snapshot data, inspect single keys, scan catalogs, diagnose unmatched SKUs, manage baselines (router with actions: preview, snapshot, inspect, reconcile, scan, reset-baseline, baseline.history, baseline.rollback, channel-cache, unmatched) ### Field mapping - `pullpush.mapping.suggest` β€” AI-proposes field mapping from source sample to target shape; returns mapping, confidence, preview - `pullpush.mapping.validate` β€” Validate a mapping config against source and destination schemas - `pullpush.mapping.compare` β€” Compare two mappings side by side - `pullpush.mapping.explain` β€” Explain how a mapping transforms data, step by step - `pullpush.mapping.diff` β€” Diff two mapping versions to see what changed - `pullpush.mapping.get` β€” Get a flow's current mapping config, source fields, and destination fields ### Diagnostics - `pullpush.explain` β€” Diagnose why a flow, connection, or delivery failed; gathers errors, identifies patterns, suggests fixes - `pullpush.diagnose.recent` β€” Scan all flows for recent failures; returns a prioritized issue list - `pullpush.ask` β€” Answer natural-language ops questions using tenant failures and anomalies ### Connector authoring - `pullpush.connector.generate` β€” AI-generates TypeScript connector code, typechecks, tests, and registers - `pullpush.connector` β€” List, get, update, and manage connector definitions (router) ### Data operations - `pullpush.data.push` β€” Push file data (CSV, JSON, XML) into a connection - `pullpush.import` β€” File-based data import operations (router) - `pullpush.export` β€” Scheduled export pipelines: create, list, update, delete, test, run (router) - `pullpush.canonical` β€” Inspect and manage canonical data models (router) ### Shadow mode & safety - `pullpush.shadow` β€” Run integrations read-only before going live; compare shadow vs live results (router) ### Batch operations - `pullpush.batch.test` β€” Test multiple connections in parallel - `pullpush.batch.status` β€” Get status matrix across all flows - `pullpush.batch.setup` β€” One-call setup: create connections + flow + test in one operation - `pullpush.batch` β€” Multi-flow batch operations and proactive reports (router) ### Ops & health - `pullpush.health.overview` β€” Tenant health dashboard: connections, flows, failures, backlog, delivery rate, anomalies - `pullpush.health.mcp` β€” MCP server health: database, tools registered, uptime - `pullpush.ops` β€” Anomaly detection, dead-letter recovery, operation monitoring (router) ### Workflows - `pullpush.workflow.create` β€” Create multi-step workflow with trigger and step DAG - `pullpush.workflow.trigger` β€” Manually trigger a workflow run from an existing event - `pullpush.workflow` β€” List, get, and manage workflows (router) ### Integrations & marketplace - `pullpush.integration.create` β€” Create an integration grouping flows/workflows under one name - `pullpush.integration` β€” List and manage integrations (router) - `pullpush.marketplace.install` β€” Install a marketplace listing into your tenant - `pullpush.marketplace` β€” Browse and manage marketplace connectors (router) - `pullpush.destination.provision` β€” Provision custom fields on destination API (e.g. HubSpot properties) ### Administration - `pullpush.tenant` β€” Tenant management: list, get, create, update (router) - `pullpush.billing` β€” Subscription and usage management (router) - `pullpush.partner` β€” Partner program operations (router) - `pullpush.backup` β€” Backup and restore operations (router) - `pullpush.feedback` β€” Submit feedback about MCP tool quality or missing features Full tool reference: [pullpush.ai/docs/mcp](https://pullpush.ai/docs/mcp) ## Environment variables | Variable | Required | Default | Description | | --- | --- | --- | --- | | `PULLPUSH_API_KEY` | Yes | β€” | Your PullPush API key | | `PULLPUSH_API_URL` | No | `https://api.pullpush.ai` | API base URL (override for self-hosted) | ## Auth scopes | Scope | Access | | --- | --- | | **Tenant key** | Your tenant's connections, flows, sync, diagnostics | | **Org key** | All tenants in your organization (read or read+write) | | **Admin key** | Full platform access (billing, partners, all tenants) | Tools are automatically scoped: a tenant key never sees another tenant's data. ## Features - **Auto-refresh**: tool catalog refreshes every 5 minutes β€” new server-side tools appear without a restart - **Offline quickstart**: built-in `pullpush://docs/quickstart-local` resource works without network - **Retry on unknown tool**: automatically refreshes the catalog when a tool is not found - **Clear error messages**: auth failures, network issues, and version mismatches are explained ## Documentation - [Getting started](https://pullpush.ai/docs/getting-started) β€” 5 minutes to a first integration - [MCP guide](https://pullpush.ai/docs/mcp) β€” full tool reference and client setup - [Shadow mode](https://pullpush.ai/docs/shadow-mode) Β· [Preview & reconcile](https://pullpush.ai/docs/preview-reconcile) Β· [Security](https://pullpush.ai/docs/security) - [llms.txt](https://pullpush.ai/llms.txt) β€” machine-readable product summary - [Machine-readable integration catalog](https://pullpush.ai/api/integrations) - MCP registry entry: [`ai.pullpush/pullpush-mcp`](https://registry.modelcontextprotocol.io/v0/servers?search=ai.pullpush/pullpush-mcp) ## Also available: pullpush-mcp-dev For connector authors, platform admins, and internal developers, [pullpush-mcp-dev](https://www.npmjs.com/package/pullpush-mcp-dev) exposes additional tools for: - AI-powered connector generation and composition - Canonical schema management - Marketplace publishing - Billing and partner administration - Batch operations across all tenants ## Development ```bash git clone https://github.com/Kaduno-systems/pullpush-mcp.git cd pullpush-mcp npm install npm run dev # Run from source via tsx npm run build # Compile with tsup ``` This repository is a published mirror of the MCP client package; the platform itself is developed in a private monorepo. Issues and questions are welcome here or at [hello@pullpush.ai](mailto:hello@pullpush.ai). ## License MIT ## Development Development happens in the PullPush platform monorepo; the [Kaduno-systems/pullpush-mcp](https://github.com/Kaduno-systems/pullpush-mcp) repository is a published mirror of each release. Issues are welcome there; code changes land via the monorepo.