Vignetim Claude MCP

Connect the Vignetim Partner API directly to Claude Code or Claude Desktop. Your assistant will be able to browse products, create orders, manage webhooks, and search documentation.

Quick Setup

Claude Code (CLI)

claude mcp add vignetim --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

For sandbox testing:

claude mcp add vignetim-sandbox --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_SANDBOX_KEY" \
  --header "X-API-Secret: YOUR_SANDBOX_SECRET" \
  --header "X-Environment: sandbox"

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Restart Claude Desktop after saving.

Available Tools

Products

Tool	Description	Example
`list_tickets`	Browse vignette tickets	"Show me Austrian vignettes for cars"
`get_ticket`	Get ticket details	"Get details for ticket abc-123"
`list_esim_packages`	Browse eSIM packages	"What eSIM packages are available for Turkey?"
`list_insurance_products`	Browse insurance	"List all insurance products"
`get_insurance_product`	Get insurance details	"Tell me about green card insurance"
`list_vehicle_categories`	Browse vehicle types	"What vehicle categories exist?"

Orders

Tool	Description	Example
`create_order`	Create an order	"Create a vignette order for Austria"
`list_orders`	List your orders	"Show my recent orders"
`get_order`	Get order details	"What's the status of order xyz?"
`get_order_status`	Check order status	"Is order xyz completed?"

Webhooks

Tool	Description	Example
`create_webhook`	Register endpoint	"Set up a webhook for order.completed events"
`list_webhooks`	List webhooks	"Show my registered webhooks"
`update_webhook`	Update webhook	"Disable webhook abc"
`delete_webhook`	Delete webhook	"Remove webhook abc"
`test_webhook`	Send test event	"Send a test event to webhook abc"

Documentation

Tool	Description	Example
`list_docs`	Browse docs	"What API docs are available?"
`get_doc`	Read a section	"Show me the authentication docs"
`search_docs`	Search docs	"How do I handle errors?"
`get_openapi_spec`	Get OpenAPI spec	"Where's the OpenAPI spec?"

Usage Examples

Browsing Products

You: What vignettes are available for Hungary?

Claude: [calls list_tickets with countryIsocode: "HU"]
        Found 12 vignette options for Hungary:
        - 10-day highway vignette (Category D1) — €14.90
        - Monthly highway vignette (Category D1) — €19.90
        ...

Managing Webhooks

You: Set up a webhook at https://myapp.com/webhooks/vignetim
     for order completed and failed events.

Claude: [calls create_webhook with url, events]
        Webhook registered successfully!
        ID: 7f3a...
        Signing Secret: abc123...  (save this — it's only shown once)

Checking Order Status

You: Show me all failed orders from this week.

Claude: [calls list_orders with status filter and date range]
        Found 2 failed orders:
        1. Order #abc - Failed at 2026-03-18 (vignette, AT)
        2. Order #def - Failed at 2026-03-19 (eSIM, global)

Team Configuration

Add to your project's .claude/settings.json for team-wide access:

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Troubleshooting

"API credentials required"

This error appears when using API tools without credentials. Ensure both X-API-Key and X-API-Secret headers are configured.

"Authentication failed"

Verify your API key and secret are correct
Check that your key is active in the Vignetim Partner Dashboard
Ensure your IP is whitelisted (if IP restrictions are enabled)

Sandbox vs Production

Use the X-Environment: sandbox header to test against the sandbox API. Sandbox mode uses simulated payments and test data.