How to Use the Image Router MCP in LangChain

Q: How does the Image Router handle model selection inside a LangChain agent?

The agent calls listmodelsbycategory to inspect available engines and matches them against your prompt's style. The Image Router MCP Server exposes these tools directly, allowing the agent to decide whether to route the request to a high-end model or a faster option.

Q: Can I trace Image Router tool calls using LangSmith?

Yes, every tool call like generateimage or editimage is exposed as a native LangChain tool. LangSmith captures the exact inputs, latency, and routing decisions made by the server.

Q: What happens if a selected image model is down?

Your chain can call checkimagerouterstatus to verify active connections. If a backend fails, the agent reads the error, calls listmodels to find a backup, and tries again.

Let your LangChain agents pick the perfect image generation engine on the fly without writing hardcoded routing logic.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Image Router MCP to LangChain

Create your Vinkius account to connect Image Router to LangChain and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Image Router with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Dynamic tool chains for visual tasks

Your LangChain agents can now analyze a user's prompt and decide which generation engine fits best. By exposing tools like `generate_image` and `list_styles` directly to your chains, the agent inspects the style requirements before committing to a specific backend. You don't have to write complex routing rules or maintain API endpoints for five different image providers. When an agent runs, it feeds the output of `list_models_by_category` into its reasoning loop to match the request with the cheapest or fastest model. If the user wants a modification, the agent transitions to `edit_image` or `upscale_image` within the same execution path. LangSmith tracks every step, showing you exactly why a specific model was chosen.

LangChain agents that self-correct

Sometimes an image generation API drops or times out. This LangChain MCP Server lets your agent check the system health using `check_imagerouter_status` before firing off heavy payloads. If a model fails to respond, the agent catches the error, grabs alternatives via `list_models`, and reroutes the request instantly. You can build chains that poll for results using `get_generation_status` without blocking the main thread. The agent handles the asynchronous wait, evaluates the output, and triggers `generate_variation` if the visual quality doesn't meet the prompt's criteria. This keeps your generation pipelines running even when upstream providers are shaky.

Granular control over advanced generation

Give your ReAct agents the exact parameters they need for complex rendering jobs. By exposing this MCP Server to your ReAct agents, they get the exact parameters they need for complex rendering jobs. Your chain can pass aspect ratios, negative prompts, and seed values that match the specific model metadata fetched from `get_model` via `generate_image_advanced`. This setup means you stop guessing which parameters work with which engine. The agent queries `list_styles` to validate the user's aesthetic choice, matches it against active models, and executes. It turns a fragile text-to-image prompt into a predictable, multi-step pipeline.

Setup guide

Set up Image Router MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Image Router tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "image-router-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Image Router transactions"
    })
    print(result["messages"][-1].content)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Image Router. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Image Router now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Image Router MCP in LangChain

The agent calls `list_models_by_category` to inspect available engines and matches them against your prompt's style. The Image Router MCP Server exposes these tools directly, allowing the agent to decide whether to route the request to a high-end model or a faster option.

Yes, every tool call like `generate_image` or `edit_image` is exposed as a native LangChain tool. LangSmith captures the exact inputs, latency, and routing decisions made by the server.

You don't need to manage multiple keys in your LangChain code. The Image Router MCP Server handles authentication on the Vinkius side, letting your agent focus on calling `generate_image` with a single endpoint token.

Your chain can call `check_imagerouter_status` to verify active connections. If a backend fails, the agent reads the error, calls `list_models` to find a backup, and tries again.

Your prompts and image data are processed in ephemeral V8 isolates that wipe clean immediately after the tool execution finishes. We never store your raw image files or prompt strings on Vinkius servers, ensuring your creative assets remain private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript