MCP Server

Model Context Protocol — Let AI assistants manage your data infrastructure by connecting them directly to Vendo.

Overview

The Vendo MCP Server exposes the full Account Management API to AI tools that support the Model Context Protocol. This enables AI assistants to:

List and manage your apps, sources, and integrations
Monitor sync jobs and troubleshoot issues
Trigger manual syncs and configure schedules
Create and modify data models

Prerequisites

API Key — Create an API key from Settings → API Keys
MCP-compatible client — Claude Desktop, Cursor, Windsurf, or any MCP-compatible tool

Endpoint

The MCP server is available at:


https://app.vendodata.com/api/mcp

Client Configuration

Claude Desktop

Add this to your Claude Desktop configuration (~/.claude_desktop/settings.json):


{
  "mcpServers": {
    "vendo": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-proxy",
        "https://app.vendodata.com/api/mcp"
      ],
      "env": {
        "MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_API_KEY\"}"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key (starts with vendo_sk_).

Cursor

Add to your Cursor MCP configuration:


{
  "mcpServers": {
    "vendo": {
      "url": "https://app.vendodata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Add to your Windsurf configuration:


{
  "mcpServers": {
    "vendo": {
      "serverUrl": "https://app.vendodata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Add to your Claude Code MCP settings (.mcp.json in your project):


{
  "mcpServers": {
    "vendo": {
      "url": "https://app.vendodata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Available Tools

The MCP server provides 40+ tools organized by resource type:

Catalog Tools

Tool	Description
`catalog_list`	List available integration types in the Vendo catalog
`catalog_get`	Get details for a specific integration type

Apps Tools

Tool	Description
`apps_list`	List all app connections
`apps_get`	Get details for a specific app
`apps_create`	Create a new app connection
`apps_update`	Update an app’s configuration
`apps_delete`	Delete an app (soft delete)
`apps_pause`	Pause an app connection
`apps_resume`	Resume a paused app

Sources Tools

Tool	Description
`sources_list`	List all data sources
`sources_get`	Get details for a specific source
`sources_create`	Create a new data source
`sources_update`	Update a source’s configuration
`sources_delete`	Delete a source (soft delete)
`sources_pause`	Pause a data source
`sources_resume`	Resume a paused source
`sources_sync`	Trigger a manual sync

Destinations Tools

Tool	Description
`destinations_list`	List all data destinations
`destinations_get`	Get details for a specific destination
`destinations_create`	Create a new destination
`destinations_update`	Update a destination’s configuration
`destinations_delete`	Delete a destination (soft delete)

Integrations Tools

Tool	Description
`integrations_list`	List all integrations
`integrations_get`	Get details for a specific integration
`integrations_create`	Create a new integration
`integrations_update`	Update an integration’s configuration
`integrations_delete`	Delete an integration (soft delete)
`integrations_pause`	Pause an integration
`integrations_resume`	Resume a paused integration
`integrations_sync`	Trigger a manual sync

Jobs Tools

Tool	Description
`jobs_list`	List all sync jobs
`jobs_get`	Get details for a specific job
`jobs_cancel`	Cancel a running or pending job

Models Tools

Tool	Description
`models_list`	List all data models
`models_get`	Get details for a specific model
`models_create`	Create a new data model
`models_update`	Update a model’s configuration
`models_delete`	Delete a data model

Read-Only Mode

Append ?read_only=true to the MCP URL to disable all mutation operations:


https://app.vendodata.com/api/mcp?read_only=true

In read-only mode, only *_list and *_get tools are available. This is useful for:

Monitoring and reporting scenarios
Shared API keys with limited permissions
Preventing accidental modifications

Usage Examples

Once connected, you can ask your AI assistant natural language questions:

Listing resources:

“Show me all my active Shopify sources”

Checking status:

“What’s the status of my latest sync jobs?”

Troubleshooting:

“Why did my Google Ads integration fail?”

Taking actions:

“Pause my Stripe integration” “Trigger a sync for my Shopify source”

Authentication

The MCP server uses the same API key authentication as the REST API. Your API key determines:

Which account’s resources are accessible
Rate limits (requests per minute/day)
Available scopes (if configured)

Rate Limits

MCP requests count against your API key’s rate limits:

Limit	Default
Per minute	60 requests
Per day	10,000 requests

Troubleshooting

”Unauthorized” errors

Verify your API key is correct and hasn’t been revoked
Check that the Authorization header is properly formatted
Ensure your API key has the necessary scopes

Connection timeouts

The MCP server uses Server-Sent Events (SSE) for streaming
Some proxies or firewalls may not support long-lived connections
Try using the JSON response mode if available in your client

Tools not appearing

Restart your MCP client after configuration changes
Check for JSON syntax errors in your configuration file
Verify the MCP server URL is accessible from your network

Security Considerations

Never commit API keys — Use environment variables or secrets management
Use read-only mode — When you only need monitoring capabilities
Rotate keys regularly — Create new keys and revoke old ones periodically
Monitor usage — Check API request logs in your Vendo dashboard

Next Steps

Authentication — Learn about API key management
Apps — Understand app resources
Error Handling — Handle errors gracefully