Connections & Capabilities
Connects To
Capabilities
Quickstart
Config
{
"mcpServers": {
"macrocosmos": {
"command": "uvx",
"args": ["macrocosmos-mcp"],
"env": {
"MC_API": "<insert-your-api-key-here>"
}
}
}
}Exposed MCP Tools (7)
query_on_demand_dataFetches real-time data from X (Twitter) and Reddit based on specified keywords or usernames.
Read-only operation; retrieves data without modifying any state.
create_gravity_taskCreates a data collection task to gather large datasets from X or Reddit over a specified period.
Initiates data collection, which involves writing data but does not directly modify system settings.
get_gravity_task_statusRetrieves the status of a running data collection task, including progress and collected data volume.
Read-only operation; provides information about existing tasks.
build_datasetBuilds a dataset from collected data, stopping the crawler and preparing the data for download.
Stops the crawler and prepares data, but does not delete or modify core system components.
get_dataset_statusChecks the build progress of a dataset and provides download links when ready.
Read-only operation; provides information about dataset build status and download links.
cancel_gravity_taskCancels a running data collection task, stopping the data gathering process.
Stops a running task, but does not delete any data or modify system settings.
cancel_datasetCancels a dataset build or purges a completed dataset, removing it from the system.
Cancels a build or purges a dataset, which involves data deletion but does not affect core system functionality.
Safety Assessment
Macrocosmos MCP offers a balance of data access and control. It is safe for read-only queries and controlled data collection within defined limits. Risks arise from potential API key compromise and the ability to prematurely stop data collection tasks, requiring careful management of credentials and task parameters.
- API key authentication
- Rate limiting on API usage
- Clear separation of read and write operations
- User-defined limits on data collection
- Data collection tasks have a defined lifespan
- Potential for data scraping abuse if rate limits are too high
- API key compromise could lead to unauthorized data access
- No explicit sandboxing for data collection tasks
- Email notifications could expose data collection details
- Crawler tasks can be stopped and datasets built prematurely, potentially losing data
