Agora MCP

Agora MCP

By Fewsats GitHub

Agora MCP server to search & buy across thousands of online stores

agora-mcp product-search
Overview

What is Agora MCP?

Agora MCP is a server that connects AI assistants to SearchAgora, a universal product search engine, enabling users to search, discover, and purchase products from various online stores seamlessly.

How to use Agora MCP?

To use Agora MCP, set it up with an MCP client like Cursor or Claude Desktop, configure the server settings, and interact with your AI assistant to search for products and manage purchases.

Key features of Agora MCP?

  • Seamless integration with AI assistants for product search and purchase.
  • Customizable search parameters including price ranges and sorting options.
  • Future support for shopping cart management and order tracking.

Use cases of Agora MCP?

  1. Searching for specific products using natural language queries.
  2. Comparing product options based on price and ratings.
  3. Managing shopping carts and completing purchases through AI interactions.

FAQ from Agora MCP?

  • What AI assistants can I use with Agora MCP?

You can use it with Cursor and Claude Desktop.

  • Is there a cost to use Agora MCP?

The usage of Agora MCP is free, but you may need to pay for the products you purchase.

  • What features are coming soon?

Features like shopping cart management, order tracking, and saving favorite products are planned for future updates.

Content

Agora MCP

An MCP server for searching, discovering, and purchasing products through AI assistants like Claude or Cursor.

What is Agora MCP?

Agora MCP connects AI assistants to SearchAgora - a universal product search engine that helps you discover and buy products from across the web. With this MCP, you can seamlessly search for products, compare options, manage your shopping cart, and complete purchases directly through your AI assistant.

Prerequisites

Setting Up the MCP Server

For Cursor

  1. Open Cursor and go to Settings
  2. Navigate to MCP Server Configuration
  3. Add the following configuration:
{
  "mcpServers": {
    "Agora": {
      "command": "uvx",
      "args": [
        "agora-mcp"
      ]
    },
    "Fewsats": {
      "command": "env",
      "args": [
        "FEWSATS_API_KEY=YOUR_FEWSATS_API_KEY",
        "uvx",
        "fewsats-mcp"
      ]
    }
  }
}

Make sure to replace YOUR_FEWSATS_API_KEY with your actual API key from Fewsats.

For Claude Desktop

  1. Find the configuration file:

    • On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • On Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. Add the following configuration:

"mcpServers": {
  "Agora": {
    "command": "uvx",
    "args": [
      "agora-mcp"
    ]
  },
  "Fewsats": {
    "command": "env",
    "args": [
      "FEWSATS_API_KEY=YOUR_FEWSATS_API_KEY",
      "uvx",
      "fewsats-mcp"
    ]
  }
}

Running a Local Development Version

For development purposes, you can run a local version of the Agora MCP from your own repository:

"Agora": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/your/agora-mcp",
    "run",
    "agora-mcp"
  ]
}

Replace /path/to/your/agora-mcp with the actual path to your local Agora MCP repository.

Using Agora MCP With Your AI

Once configured, you can have natural conversations with your AI to search for and purchase products:

Searching for Products

Simply ask your AI to search for products:

Can you find a cool t-shirt for me?

Advanced Search Options

Refine your search with additional parameters:

Show me headphones under $100 sorted by highest rating

The search supports:

  • Price ranges (min/max)
  • Pagination
  • Custom sorting
  • Product filtering

Coming Soon: Shopping Cart & Purchasing

Soon you'll be able to:

Add that red t-shirt to my cart

Show me what's in my cart

Checkout and purchase my items

Supported Features

Currently, Agora MCP supports:

  • Product search with customizable parameters:
    • Search query
    • Results per page
    • Page navigation
    • Price filtering (minimum and maximum)
    • Custom sorting options

Coming soon:

  • Add products to cart
  • View and manage shopping cart
  • Complete purchases
  • Save favorite products
  • Track order status

About SearchAgora

SearchAgora is a universal product search engine that helps you discover products from across the web. It offers a seamless shopping experience with comprehensive product information, price comparisons, and streamlined checkout processes.

No tools information available.
No content found.