# Pullpush MCP

> Pullpush MCP is a freemium MCP server for cloud and infrastructure. Build, preview and monitor data syncs between two APIs from your AI agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web, CLI
- **Website:** https://pullpush.ai
- **Repository:** https://github.com/kaduno-systems/pullpush-mcp
- **MCP Registry name:** ai.pullpush/pullpush-mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

Stock levels that disagree between a shop and a warehouse are the demo scenario for PullPush, an integration platform for e-commerce stores, marketplaces, ERPs and POS systems. The MCP server hands agents the whole lifecycle: connect two systems, map fields, preview, cut over and monitor. The registry entry counts 50 tools covering connections, flows, reconciliation, diagnostics and connector authoring.

New flows start in shadow mode, which is read-only. A sync preview returns a structured source-versus-destination diff before anything is written. The sync engine is deterministic, with AI used only when generating connectors and mapping suggestions. Errors come back as code, suggestion, suggestedTool and retryable, so an agent knows its next step, and connection secrets are encrypted server-side so the MCP layer sees references only.

A single curl call creates a free 48-hour sandbox with an API key and two demo systems; claim it with an email to keep it. The server runs hosted over streamable HTTP or locally as an stdio proxy, and is MIT licensed.

## Features

- **Shadow mode:** Flows start read-only so nothing is written until you cut over.
- **Sync preview:** pullpush.sync with action preview shows drifted quantities and missing items.
- **Actionable errors:** Failures carry a code, suggestion, suggested tool and retry flag.
- **Server-side secrets:** Credentials are envelope-encrypted and never reach the agent.
- **Get-started prompt:** A built-in prompt walks an agent from zero to a working integration.
- **Reliability controls:** Circuit breakers, idempotency, ordered delivery and a dead-letter queue.

## Good for

- Check that a shop and warehouse agree on stock before going live
- Migrate between systems while proving the data matches
- Let an agent connect two APIs and monitor the sync
- Diagnose a failed sync and retry from the dead-letter queue

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pullpush-mcp https://api.pullpush.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.pullpush.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pullpush-mcp": {
      "url": "https://api.pullpush.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pullpush-mcp": {
      "type": "http",
      "url": "https://api.pullpush.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pullpush-mcp": {
      "serverUrl": "https://api.pullpush.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pullpush-mcp": {
      "type": "http",
      "url": "https://api.pullpush.ai/mcp"
    }
  }
}
```

## Tools

- `pullpush.sync`: Run a sync, with action preview showing a source-versus-destination diff without writing.

## FAQ

### Can I try it without signing up?

Yes, a curl POST to the sandbox endpoint returns a free 48-hour tenant with an API key and demo systems.

### Does an LLM run the sync?

No. The README says the runtime is deterministic, with AI used only at build time.

### Which transports are offered?

Hosted streamable HTTP at api.pullpush.ai/mcp, or an npm stdio proxy for clients that need it.

### What does the free plan include?

Two connections, 1,000 events a month, up to 5 data types and shadow-mode preview.

### Is Pullpush MCP free?

Pullpush MCP has a free plan, with paid plans for more usage or features.

### How do I add Pullpush MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http pullpush-mcp https://api.pullpush.ai/mcp

### What are the best alternatives to Pullpush MCP?

The closest alternatives to Pullpush MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pullpush-mcp
