Overview
An MCP server exposing the ImproveDigital API for publisher inventory management via the Model Context Protocol. It authenticates using OAuth2 Client Credentials and dynamically generates MCP tools from a curated OpenAPI/Swagger document, enabling publishers to list, view, and modify inventories, zones, and placements. The server provides generated tools such as inventories_get_inventories, inventories_get_inventory_zones, inventories_get_inventory_placements, inventories_get_inventory_placement, inventories_create_inventory_placement, and inventories_update_inventory_placement. Tools include dynamic schemas, parameter mapping, request routing, and response handling with full $ref resolution. Architecture pairs an MCP Client with a dynamic tool registry and an API provider (ImproveDigital) through a Swagger-backed contract. The server supports multiple transport modes (HTTP for production and Stdio for development) and runs under configurable ports. It can be used from MCP Inspector, Claude, Cursor, or programmatically via createMcpContext to initialize tools and return an MCP server instance. This makes it easy for AI agents to manage publisher inventories programmatically.
Features
Dynamic tool generation from Swagger
Tools are automatically generated from a curated Swagger/OpenAPI document, creating MCP tools that map to API endpoints with dynamic schemas and routing.
OAuth2 Client Credentials and token management
Authentication is handled via OAuth2 client credentials with Bearer token management and automatic token handling.
Auto-generated MCP tools for inventories, zones and placements
Includes a set of provided tools to list inventories, zones, placements, and to fetch, create, or update placements.
Dynamic tool schemas with parameter mapping
Each tool automatically validates path, query, and body parameters and resolves OpenAPI references for robust requests.
Multiple transport modes
Supports HTTP transport for production and Stdio transport for development, with configurable port and transport settings.
Programmatic integration via createMcpContext
Exported createMcpContext enables embedding in external apps to initialize MCP tools and the server instance.
Who Is This For?
- Publishers:Use MCP to integrate ImproveDigital inventory management with AI tools to list and manage placements.
