MCP Tools

PullPush exposes 80+ Model Context Protocol (MCP) tools that let AI assistants build, monitor, and manage connectors directly from your IDE.

What is MCP?

MCP is an open protocol that connects AI models to external tools and data sources. PullPush implements an MCP server that gives AI assistants (Claude, GPT, Cursor) access to your sync infrastructure.

Available tool groups

Build tools

Tool	Description
`discover`	Discover API endpoints from a URL or documentation
`generate_connector`	Generate a connector definition from API docs
`validate_definition`	Validate a connector definition against the schema
`test_connector`	Test a connector's authentication and basic operations

Sync tools

Tool	Description
`preview_flow`	Run a preview comparing source and destination
`reconcile_flow`	Run incremental reconciliation
`flow_status`	Check the status of a sync flow
`dlq_list`	List dead-letter queue entries
`dlq_retry`	Retry failed events

Connector definition tools

Tool	Description
`list_definitions`	List all connector definitions
`get_definition`	Get a specific connector definition
`create_definition`	Create a new connector definition
`update_definition`	Update an existing definition
`publish_definition`	Publish a definition to the marketplace

Canonical tools

Tool	Description
`list_canonical_types`	List all canonical data types
`validate_canonical`	Validate data against a canonical schema
`map_fields`	Generate field mapping suggestions

Monitoring tools

Tool	Description
`system_health`	Check overall system health
`connection_status`	Check connection health
`event_stats`	Get event processing statistics

Connecting MCP to your IDE

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "pullpush": {
      "url": "https://api.pullpush.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "pullpush": {
      "transport": "streamable_http",
      "url": "https://api.pullpush.ai/mcp"
    }
  }
}

MCP HTTP endpoint

The MCP server is available at POST /mcp on the API. It accepts standard MCP protocol messages and supports the streamable_http transport.

For detailed tool documentation, see the full MCP tools reference.