MarketAuxMcpServer

MarketAux MCP Server is a Node.js-based MCP server that integrates the Marketaux API to enable search and retrieval of market data such as entities, countries, industries, symbols, and more. The server exposes tools like market_aux_news_search, which leverages Marketaux search endpoints to filter results by symbols, entity_types, industries, countries, language, and published dates. To use it, start the server with Node.js and provide your Marketaux API key via the MARKETAUX_API_KEY environment variable. Once running, you can invoke the MCP client tooling to perform searches against the Marketaux API through the MCP interface, receiving structured results suitable for downstream processing or display. Note that only the Free Tier endpoint is implemented in this version, so responses and rate limits will align with the free tier capabilities.

Prerequisites:

• Node.js installed (recommended LTS version)
• Access to a machine with filesystem permissions to run Node.js apps

Installation steps:

1. Prepare the project:
   • Clone or download the MarketAux MCP Server project.
   • Navigate to the project folder.
2. Install dependencies:
   • Run: npm install
3. Build (if a build step is required by the project):
   • Run: npm run build (or follow the project’s build instructions to produce build/index.js)
4. Configure environment:
   • Ensure you have a Marketaux API token from your Marketaux dashboard.
   • Create a configuration file (as shown in the README example) and set the MARKETAUX_API_KEY env var accordingly.
5. Run the server:
   • Example: MARKETAUX_API_KEY=your-token_here node build/index.js
   • Or, use a process manager/systemd script to run the command with the environment variable set.

Notes:

• The server path in the command should point to the compiled entry file (index.js in the build directory).
• If you are on Windows, use proper path escaping for the command and arguments.

Tips and considerations:

• The README indicates the Free Tier Marketaux endpoint is the only one implemented; behavior and data availability will reflect that tier.
• Ensure the MARKETAUX_API_KEY is kept secret and not checked into source control.
• If you encounter path issues, verify that the path to build/index.js is correct and that the file exists after the build step.
• If you run into connectivity or API limit errors, check your Marketaux account status and verify that the API key is active.
• This MCP server may expect additional configuration or environment variables depending on deployment; adjust env accordingly if you extend functionality.