Dealx

What is DealX?

DealX is a Model Context Protocol (MCP) server for the DealX platform that allows LLMs to search for ads. It implements the MCP specification to provide a standardized interface for LLMs to interact with the DealX platform.

How to use DealX?

Install via npm (npm install -g @dealx/mcp-server) or run with npx (npx -y @dealx/mcp-server). Configure the server in your LLM’s MCP settings (e.g., Claude Desktop or Cline) by adding a dealx entry under mcpServers with the command npx, args ["-y", "@dealx/mcp-server"], and environment variable DEALX_API_URL set to https://dealx.com.ua. Then use natural language prompts like “Search for ads on DealX with the query 'laptop'”.

Key features of DealX

• Provides a search_ads tool for querying ads.
• Supports pagination with offset and limit parameters.
• Allows sorting results (e.g., newest first).
• Designed to be easily extended with additional tools.
• Hosted deployment available on Fronteir AI.
• Works with any MCP-compatible LLM client.

Use cases of DealX

• Search for products or services on DealX using natural language.
• Find the newest ads for a specific item (e.g., “iPhone”).
• Search for ads in a specific location (e.g., “apartments in Kyiv”).
• Integrate DealX ad search into AI assistants or chatbots.

FAQ from DealX

What runtime does DealX require?

Node.js v20 or later and npm v11 or later.

How do I configure DealX with my LLM?

Add the server to your LLM’s MCP configuration file (e.g., claude_desktop_config.json) with the command npx, args ["-y", "@dealx/mcp-server"], and environment variable DEALX_API_URL set to https://dealx.com.ua.

What tools does DealX currently support?

Currently only search_ads. Future tools planned include create_ad, edit_ad, delete_ad, get_threads, and create_thread.

How can I extend DealX with new tools?

Define the tool in the TOOLS object, create a new file in src/tools, add it to the ListToolsRequestSchema and CallToolRequestSchema handlers, and import it in src/index.ts.

What should I do if the server fails to start?

Check Node.js version, ensure dependencies are installed, verify the .env file exists with correct values, and review console error messages.