Using MCP Servers

Not yet available. Native MCP server orchestration through the OpenDunes API is tracked to be built — today, run MCP servers yourself and drive the tools loop with live tool calling on the chat completions API (see below). This page describes the planned integration.

The Model Context Protocol (MCP) lets AI models call external tools — file systems, databases, APIs — through a standardized interface. Once the OpenDunes MCP layer is live, you'll be able to attach MCP servers to any model in the catalog and have usage billed in DA.

How it will work#

MCP sits between your client and the model. Your client connects to one or more MCP servers, which expose tools. When a model decides to call a tool, the request routes through the MCP layer:

Your app → OpenDunes API → Model → MCP Server(s) → Result → Model → Response

You'll declare servers and grant the model permission to call them in the request:

{
  "model": "anthropic/claude-opus-4.8",
  "messages": [...],
  "mcp_servers": [
    {
      "name": "filesystem",
      "url": "mcp://localhost:3001",
      "allowed_tools": ["read_file", "list_directory"]
    }
  ]
}

What's coming#

• First-class mcp_servers parameter on POST /v1/chat/completions.
• Managed MCP server registry for common integrations (web search, code execution, document stores).
• Per-server access controls and audit logs.
• DA billing for both the model tokens and MCP tool calls (where applicable).

Run MCP servers today alongside OpenDunes#

You don't need to wait — you can run MCP servers locally and orchestrate them yourself using the OpenAI SDK. The model handles tool-calling; your code executes the tool and feeds the result back as a tool role message.

Tool calling is live today on POST /v1/chat/completions — pass tools and tool_choice exactly as you would with the OpenAI API. See Tool Calling for the full request shape.

Stay updated#

Watch the OpenDunes changelog for the MCP integration announcement.

Next steps#

• Automatic Code Review — multi-step agent loop using OpenDunes today.
• Claude Code — Claude Code has built-in MCP support.
• Models — browse models with tools capability.