Loading...
Macrocosmos MCP provides real-time social media data from X and Reddit via on-demand queries and large-scale data collection, accessible through an API key.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
Macrocosmos MCP provides real-time social media data from X and Reddit via on-demand queries and large-scale data collection, accessible through an API key.
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.
Performance depends on the volume of data being collected and the rate limits imposed by the underlying social media platforms. Large-scale data collection tasks may take significant time to complete.
Cost is based on API usage, with a free tier providing limited credits. Large-scale data collection can incur significant costs, requiring careful planning and monitoring of usage.
{
"mcpServers": {
"macrocosmos": {
"command": "uvx",
"args": ["macrocosmos-mcp"],
"env": {
"MC_API": "<insert-your-api-key-here>"
}
}
}
}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.
API Key
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.
Autonomy is limited by the need for an API key and the defined parameters of each tool. There is no sandboxing or rollback support, requiring careful planning of tasks.
Production Tip
Monitor API usage and task progress regularly to ensure data collection is proceeding as expected and to avoid exceeding rate limits.
Currently, Macrocosmos MCP supports data collection from X (Twitter) and Reddit.
You can obtain an API key from the Macrocosmos website after creating an account.
Yes, there is a free tier with a limited amount of credits to start.
A Gravity task is a large-scale data collection task that runs for up to 7 days.
Use the `get_gravity_task_status` tool to check the status and collected data volume.
Datasets are provided in Parquet file format.
Yes, you can cancel a running Gravity task using the `cancel_gravity_task` tool.