Skip to main content

​
Overview

Mirobody Health functions as an OAuth-enabled MCP Server that exposes all your tools to AI clients like Claude Desktop, Cursor, and custom MCP clients.
The Model Context Protocol (MCP) is a standard interface for AI applications to access tools, resources, and context.

​
MCP Configuration

​
For Claude Desktop & Cursor

Add Mirobody Health to your MCP configuration:
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mirobody_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "universal-mcp-proxy"
      ],
      "env": {
        "UMCP_ENDPOINT": "http://localhost:18080/mcp"
      }
    }
  }
}
Configuration file location:
~/Library/Application Support/Claude/claude_desktop_config.json
For Cursor:
~/.cursor/mcp_config.json

​
Restart Your Client

After updating the configuration:
1

Save configuration file

Ensure your changes are saved to the MCP config file
2

Restart Claude/Cursor

Close and reopen Claude Desktop or Cursor completely
3

Verify connection

The MCP server should appear in the client’s MCP servers listIn Claude Desktop: Click the MCP icon to see connected serversIn Cursor: Check MCP status in settings
4

Test a tool

Try using one of your tools:“Can you show me my health profile?”The agent should call the get_user_health_profile tool.
You should see your Mirobody Health tools available in the AI client!

​
Authentication Flow

When using tools through MCP clients, OAuth authentication is handled automatically:
The OAuth token is managed by Mirobody Health. Users authenticate once, and tools have secure access to their data.

​
Available Endpoints

The MCP server exposes the following endpoint: Base URL: http://localhost:18080/mcp Protocol: JSON-RPC 2.0 Methods:
  • tools/list: List all available tools
  • tools/call: Execute a specific tool
  • resources/list: List available resources
  • resources/read: Read a resource

​
For ChatGPT

Mirobody Health can also function as a GPT app, enabling capabilities within ChatGPT. Read more at ChatGPT Apps.

​
Custom MCP Clients

​
Direct HTTP Requests

You can call tools directly via HTTP: 
# List all tools
curl -X POST http://localhost:18080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

# Call a tool
curl -X POST http://localhost:18080/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_user_health_profile",
      "arguments": {}
    }
  }'

​
Next Steps

Built-in Tools

Explore default health tools

Add Custom Tools

Create your own tools

MCP API Reference

Detailed MCP protocol documentation