Skip to main content

​
Tools Overview

MCP tools are functions that AI agents can call to interact with Mirobody Health. Each tool has a defined input schema and returns structured results.

​
List Available Tools

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_health_data",
        "description": "Retrieve health data for a user",
        "inputSchema": {...}
      }
    ]
  }
}

​
Tool Categories

​
Health Data Tools

Search and retrieve health indicators by keywords.Input Schema:
{
  "keywords": "string (required) - Search pattern for indicator name"
}
Returns: List of matching health indicators with timestamps, values, units, and source information.Example:
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_health_indicator",
    "arguments": {
      "keywords": "steps"
    }
  }
}
Retrieve user profile information including name, email, and health settings.Input Schema: No parameters required (uses authenticated user)Returns: User profile data including demographics and preferences.
Query genetic marker data for a user.Input Schema:
{
  "gene_name": "string (optional) - Specific gene to query"
}
Returns: Genetic marker information, alleles, and risk interpretations.

​
Visualization Tools

Render advanced data visualizations. Supports 25+ chart types.Supported Chart Types:
  • liquid - Liquid fill chart for single percentage
  • line - Line chart for time series
  • bar - Bar chart for comparisons
  • scatter - Scatter plot for correlations
  • sankey - Flow diagram
  • venn - Venn diagram for overlaps
  • network-graph - Network visualization
  • mind-map - Mind map layout
  • And more…
Input Schema:
{
  "chart_type": "string (required)",
  "data": "array (required)",
  "title": "string (optional)",
  "width": "number (optional, default: 600)",
  "height": "number (optional, default: 400)",
  "theme": "string (optional: default|academy|dark)",
  "style": "object (optional)"
}
Example:
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "render_chart",
    "arguments": {
      "chart_type": "line",
      "data": [
        {"date": "2024-01-01", "value": 8543},
        {"date": "2024-01-02", "value": 10234}
      ],
      "title": "Daily Steps",
      "width": 800,
      "height": 400
    }
  }
}

​
General Purpose Tools

Read, write, and manage files on the server.Input Schema: Varies by operation (read, write, list, delete)

​
Custom Tools

You can add custom tools by creating Python modules in the configured MCP_TOOL_DIRS. See Adding Tools for details.
Tools automatically inherit authentication context. User-specific tools receive user_info parameter with authenticated user data.
For complete tool schemas and examples, call tools/list on the MCP endpoint or see the MCP Integration Guide.