Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt

Use this file to discover all available pages before exploring further.

OpenMCP

The openmcp.json endpoint provides standardized metadata about your MCP server, allowing clients and tools to discover its capabilities. mcp-use automatically generates this endpoint based on your ServerConfig.

​
What is OpenMCP?

OpenMCP is a standardized metadata format for MCP servers. It provides a JSON endpoint that describes what tools, resources, and capabilities your server offers.

​
Why Use OpenMCP?

OpenMCP enables automatic discovery of MCP server capabilities:
  • Client Integration: MCP clients can automatically discover available tools and resources
  • Schema Information: Provides input/output schemas for tools
  • Standardized Format: Consistent format across all MCP servers
  • Easy Discovery: Clients can query /openmcp.json to understand server capabilities

​
Basic Configuration

from mcp_use.server import MCPServer

server = MCPServer(
    name="my-server",
    version="1.0.0",
    description="My MCP server"
)

@server.tool()
def greet(name: str) -> str:
    """Greet someone with a personalized message."""
    return f"Hello, {name}!"

# The openmcp.json endpoint is automatically available at /openmcp.json

​
Example Output

{
  "openmcp": "1.0",
  "info": {
    "title": "Example Server",
    "version": "0.1.0",
    "description": "This is an example server with a simple echo tool."
  },
  "capabilities": {
    "experimental": {},
    "logging": null,
    "prompts": {"listChanged": false},
    "resources": {"subscribe": false, "listChanged": false},
    "tools": {"listChanged": false},
    "completions": null
  },
  "tools": [
    {
      "name": "echo",
      "title": "Echo",
      "description": "Echoes back the message you provide.",
      "inputSchema": {
        "properties": {
          "message": {"title": "Message", "type": "string"}
        },
        "required": ["message"],
        "title": "echoArguments",
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "result": {"title": "Result", "type": "string"}
        },
        "required": ["result"],
        "title": "echoOutput",
        "type": "object"
      }
    }
  ],
  "resources": [],
  "prompts": []
}

​
Next Steps