Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirobody.ai/llms.txt

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

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.