Back to MCP Directory
Macrocosmos
Model Context Protocol moderate risk

Macrocosmos

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.

Connections & Capabilities

Connects To

GitHub

Capabilities

readwrite

Quickstart

Config

{
  "mcpServers": {
    "macrocosmos": {
      "command": "uvx",
      "args": ["macrocosmos-mcp"],
      "env": {
        "MC_API": "<insert-your-api-key-here>"
      }
    }
  }
}

Exposed MCP Tools (7)

safe
query_on_demand_data

Fetches real-time data from X (Twitter) and Reddit based on specified keywords or usernames.

Read-only operation; retrieves data without modifying any state.

moderate
create_gravity_task

Creates 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.

safe
get_gravity_task_status

Retrieves the status of a running data collection task, including progress and collected data volume.

Read-only operation; provides information about existing tasks.

moderate
build_dataset

Builds 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.

safe
get_dataset_status

Checks the build progress of a dataset and provides download links when ready.

Read-only operation; provides information about dataset build status and download links.

moderate
cancel_gravity_task

Cancels a running data collection task, stopping the data gathering process.

Stops a running task, but does not delete any data or modify system settings.

moderate
cancel_dataset

Cancels 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