Model Context Protocol (MCP)

The Vignetim Partner API provides a full Model Context Protocol (MCP) server, enabling your AI assistant to directly interact with the API — browse products, create orders, manage webhooks, and search documentation — all without leaving your IDE.

What is MCP?

MCP is an open protocol that standardizes how AI applications connect to external tools and data sources. With Vignetim's MCP server, your AI coding assistant becomes a Vignetim API client.

Capabilities

Category	Tools	Auth Required
Products	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Yes
Orders	`create_order`, `list_orders`, `get_order`, `get_order_status`	Yes
Webhooks	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Yes
Documentation	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	No

MCP Endpoint

https://vignetim.com/api/mcp

Authentication

API operation tools require your Partner API credentials via HTTP headers:

Header	Description
`X-API-Key`	Your organization API key
`X-API-Secret`	Your organization API secret
`X-Environment`	Optional: `production` (default) or `sandbox`

Documentation tools (list_docs, get_doc, search_docs, get_openapi_spec) work without authentication.

How It Works

Your AI assistant connects to https://vignetim.com/api/mcp
It discovers available tools (products, orders, webhooks, docs)
When you ask "list Austrian vignettes", the assistant calls list_tickets with countryIsocode: "AT"
The MCP server signs the request with HMAC-SHA256 and proxies it to the Partner API
Results are returned directly to your assistant

The MCP server handles all authentication complexity — HMAC signing, timestamps, nonces — so your AI agent just calls tools with simple parameters.

Platform Support

Platform	Transport	Setup Guide
Claude Code	Streamable HTTP	Vignetim Claude MCP →
Claude Desktop	Streamable HTTP	Vignetim Claude MCP →
Cursor	Streamable HTTP	Vignetim OpenAI MCP →
Windsurf	Streamable HTTP	Vignetim OpenAI MCP →
OpenAI Agents SDK	Streamable HTTP	Vignetim OpenAI MCP →
Continue	Streamable HTTP	Vignetim OpenAI MCP →

Additional Resources

OpenAPI Spec: https://vignetim.com/api/partner-openapi
LLMs.txt: https://vignetim.com/llms.txt
AI Plugin: https://vignetim.com/.well-known/ai-plugin.json