MCPAgentAI

Provides a standardized MCP server wrapping tools for time, weather, currency, stocks, dictionary, calculator, Twitter, ElizaOS, and more via HTTP or stdio interfaces.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcpagents-ai-mcpagentai": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-v",
        "/path/to/local/eliza:/app/eliza",
        "--rm",
        "mcpagentai"
      ],
      "env": {
        "TWITTER_EMAIL": "YOUR_TWITTER_EMAIL",
        "TWITTER_API_KEY": "YOUR_TWITTER_API_KEY",
        "TWITTER_PASSWORD": "YOUR_TWITTER_PASSWORD",
        "TWITTER_USERNAME": "YOUR_TWITTER_USERNAME",
        "TWITTER_CLIENT_ID": "YOUR_TWITTER_CLIENT_ID",
        "TWITTER_API_SECRET": "YOUR_TWITTER_API_SECRET",
        "TWITTER_ACCESS_TOKEN": "YOUR_TWITTER_ACCESS_TOKEN",
        "TWITTER_BEARER_TOKEN": "YOUR_TWITTER_BEARER_TOKEN",
        "TWITTER_ACCESS_SECRET": "YOUR_TWITTER_ACCESS_SECRET",
        "TWITTER_CLIENT_SECRET": "YOUR_TWITTER_CLIENT_SECRET"
      }
    }
  }
}

You can run an MCP server that wraps diverse tools into a single, standardized interface. This server enables you to deploy, manage, and orchestrate tools like time utilities, weather lookups, stock data, calculator functions, and social media automation through a consistent MCP protocol, whether you run locally or inside Docker.

How to use

You interact with the MCP server using an MCP client to load and run the available tools. Start by choosing how you want to run the server: locally on your machine for development or inside a Docker container for production-like environments. The server supports tools such as time utilities, weather lookup, currency exchange, stock data, and more, all accessible through the MCP interface.

Practical usage patterns include starting the server with your preferred timezone for local testing, then issuing commands via the MCP client to query data, perform calculations, or automate tasks across integrated tools. You can enable specific tools by configuring the agent setup so only the desired tools are loaded, and you can combine multiple tools in a single workflow for complex automations.

How to install

Prerequisites: you need Python and Docker installed on your system.

pip install mcpagentai

Run locally with a timezone setting to ensure correct time-based responses.

mcpagentai --local-timezone "America/New_York"

Or run inside Docker by building the image and launching the container.

docker build -t mcpagentai .
docker run -i --rm mcpagentai

Additional configurations and notes

You can run MCPAgentAI in Docker with a ready-made configuration that binds the Docker container to the MCP image. For example, you can start the container in a manner that mirrors local Eliza integration by mounting the Eliza path into the container.

{
  "mcpServers": {
    "mcpagentai": {
      "command": "docker",
      "args": ["run", "-i", "-v", "/path/to/local/eliza:/app/eliza", "--rm", "mcpagentai"]
    }
  }
}

Examples of integration and usage patterns

If you also want to run the server locally and through Docker, you can use both approaches in parallel for testing. The CLI approach starts the server with your preferred timezone, while the Docker approach enables you to replicate production-like environments.

You can configure the server to load only certain tools, such as Time and Weather, by adjusting the MultiToolAgent configuration in your code.

Available tools

twitter_mgmt

Automates tweeting, replies, and Twitter interactions through the MCP tool interface.

crypto_prices

Fetches the latest cryptocurrency prices and market data.

eliza_integration

Connects to ElizaOS for enhanced automation within MCPAgentAI.

time_util

Provides current time, time calculations, and timezone-aware utilities.

weather_api

Retrieves weather information from a weather API.

dictionary_lookup

Performs dictionary-based word lookups and definitions.

calculator

Evaluates mathematical expressions and returns results.

currency_exchange

Gets currency exchange rates via an API.

stocks_data

Accesses real-time and historical stock market information.

news

Retrieves latest news headlines (work in progress).

Built by

VeilStrat

AI signals for GTM teams