Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_CLIENT_URL | No | URL of the MCP Client Flask API service. By default, the system will use Sandsiv's hosted MCP service. Only provide this variable if you're deploying your own version of the data-narrator-mcp service. | |
| INSIGHT_DIGGER_API_URL | No | Backend API URL (configured in MCP server layer). |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| setup_authentication | Setup authentication credentials for Sandsiv+ Insight Digger. This must be called FIRST before any analysis tools become available. Requires your API URL and JWT token. About This System:
When to Use This System:
Capabilities:
Workflow: 7-step process: Authentication → Source Discovery → Structure Analysis → Strategy Planning → Configuration → Dashboard Creation → Insight Generation |
| validate_settings | 🔒 [Requires Authentication] Validate API settings by testing the connection to the external data API. 🔄 Auto-Cached: apiUrl and jwtToken are automatically provided from your authentication session - you typically don't need to provide these parameters. Args: apiUrl (str), jwtToken (str). Returns: {{'status': 'success'|'error', 'error': str (if status == 'error')}}. ⚠️ Please authenticate first by calling the |
| list_sources | 🔒 [Requires Authentication] List available data sources. This is typically the FIRST interactive step in data analysis. Ask user to provide a search term to filter the sources. 🔄 Auto-Cached: apiUrl and jwtToken are automatically provided from your authentication session. Only provide 'search', 'page', and 'limit' parameters as needed. Ask the user for a source name to search first. Returns: {{'count': int, 'data': [{'id': str, 'title': str, 'type': str, 'updated': str, 'numberOfColumns': int}]}}. ⚠️ Please authenticate first by calling the |
| analyze_source_structure | 🔒 [Requires Authentication] Fetches and analyzes the structure of a given data source. This is a key step after selecting a source. 🔄 Auto-Cached: apiUrl and jwtToken are automatically provided from authentication. Only provide the 'sourceId' parameter (from the previous list_sources step). Returns detailed column analysis to help formulate analytical questions. ⚠️ Please authenticate first by calling the |
| generate_strategy | 🔒 [Requires Authentication] Generate analysis strategy for a question and column analysis. This is a granular step in the analysis workflow. 🔄 Auto-Cached: 'columnAnalysis' is automatically provided from the previous analyze_source_structure step. Only provide the 'question' parameter from the user. ⚠️ Please authenticate first by calling the |
| create_configuration | 🔒 [Requires Authentication] Create dashboard configuration from question, column analysis, and strategy. This is a granular step in the analysis workflow. 🔄 Auto-Cached: 'question', 'columnAnalysis', and 'strategy' are automatically provided from previous steps. You typically don't need to provide any parameters for this tool. ⚠️ Please authenticate first by calling the |
| generate_config | 🔒 [Requires Authentication] Generate dashboard config (markdown) from question and source structure. 🔄 Auto-Cached: 'sourceStructure' is automatically provided from analyze_source_structure step. 'apiUrl' and 'jwtToken' are provided from authentication. Only provide the 'question' parameter from the user. Returns: dict (markdown configuration). ⚠️ Please authenticate first by calling the |
| create_dashboard | 🔒 [Requires Authentication] Create a dashboard from config, source structure, and API settings. This is a granular step in the analysis workflow. 🔄 Auto-Cached: 'markdownConfig' is provided from create_configuration step, 'sourceStructure' from analyze_source_structure, and 'apiUrl'/'jwtToken' from authentication. You typically don't need to provide any parameters for this tool. ⚠️ Please authenticate first by calling the |
| get_charts_data | 🔒 [Requires Authentication] Fetch data for multiple charts. This step is granular. 🔄 Auto-Cached: 'chartConfigs' is automatically provided from the create_dashboard step, and 'apiUrl'/'jwtToken' from authentication. You typically don't need to provide any parameters for this tool. Returns a summary of fetched charts (chart names). The full data is cached for the next step. ⚠️ Please authenticate first by calling the |
| analyze_charts | 🔒 [Requires Authentication] Analyzes data from all charts and returns detailed insights. This is the final analytical step. 🔄 Auto-Cached: 'chartData' is automatically provided from get_charts_data step, 'question' from the workflow, and 'apiUrl'/'jwtToken' from authentication. You typically don't need to provide any parameters for this tool. After receiving the insights, you MUST synthesize them into a final report for the user. Your report should:
⚠️ Please authenticate first by calling the |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |