Skip to Content
APIs & ToolsMCPStorefront MCP

Storefront MCP

The Storefront MCP allows custom AI agents to securely interact with your storefront, enabling them to create unique shopping experiences online and elsewhere. Build intelligent shopping assistants, conversational commerce interfaces, and personalized shopping agents that help customers browse products, manage carts, and access store information.

Authentication

Storefront MCP uses channel API keys for authentication. These keys are generated in the Finqu admin area and can be configured with specific permissions and access controls.

Generating Channel API Keys

  1. Navigate to the API keys section in your Finqu admin area
  2. Click “Create new API key” (Luo uusi API-avain)
  3. Provide a name for your key (e.g., “My integration”)
  4. Select the MCP tools you want to enable for this key
  5. Configure public key settings:
    • Expiration: Optionally set an expiration date. Leave empty if the key should not expire.
  6. Save the key

The generated API key will be used to authenticate MCP requests to your storefront.

Available Tools

The Storefront MCP provides the following tools that can be enabled for each channel API key:

Product Tools

  • search_products - Search products from store

    • Enables AI agents to search and browse your product catalog
    • Returns product listings matching search criteria
    • Supports natural language search queries such as “Show me blue running shoes under $100”

  • get_product - Get detailed product information

    • Retrieves comprehensive product details including variants, pricing, images, and descriptions
    • Provides all information needed to display products

Cart Tools

  • create_cart - Create new cart

    • Initializes a new shopping cart session
    • Returns a cart identifier for subsequent operations

  • get_cart - Get cart information

    • Retrieves current cart contents, line items, and totals
    • Provides cart state for display and management

  • add_cart_lines - Add products to cart

    • Adds products or variants to the cart with specified quantities
    • Updates cart totals automatically

  • update_cart_lines - Update cart product quantities

    • Modifies quantities of existing cart line items
    • Can increase or decrease quantities

  • remove_cart_lines - Remove products from cart

    • Removes specific line items from the cart
    • Updates cart totals after removal

Connecting Custom Agents

The Storefront MCP server is available at <webshop-domain.com>/mcp and is discoverable when enabled in your channel settings. This allows your custom agents to connect seamlessly and start creating unique shopping experiences.

Enabling MCP Discovery

  1. Navigate to your channel settings in the Finqu admin area
  2. Enable MCP server discovery for your channel
  3. The MCP server will be available at <webshop-domain.com>/mcp

Connecting Your Agent

Once MCP discovery is enabled, your custom agent can connect to the MCP server:

  1. Point your agent to <webshop-domain.com>/mcp
  2. Authenticate using your channel API key
  3. Discover available tools and resources
  4. Start building shopping experiences

Authentication

All MCP requests must be authenticated using your channel API key. Include the API key in your agent’s configuration or as part of the connection request according to your MCP client implementation.

Security Best Practices

  • Use separate keys for development and production - Never use production keys in development environments
  • Limit tool access - Only enable the MCP tools that your AI agents actually need
  • Set expiration dates - Use key expiration for temporary integrations or testing
  • Monitor usage - Review API key usage regularly to detect unauthorized access
  • Rotate keys periodically - Generate new keys and retire old ones on a regular schedule

Example Use Cases

Conversational Shopping Assistants

Build AI-powered shopping assistants that help customers discover products through natural conversation:

Customer: "I'm looking for running shoes under $100"
Agent: Uses `search_products` to find matching products and presents personalized recommendations

Personalized Shopping Experiences

Create custom shopping agents that learn customer preferences and provide tailored product suggestions:

Agent: Remembers customer's style preferences and uses `search_products` to show relevant items
Customer: "Add these to my cart"
Agent: Uses `add_cart_lines` to add selected products

Multi-Channel Shopping Agents

Deploy shopping agents across different platforms (websites, messaging apps, voice assistants) that all connect to your storefront via MCP:

Voice Assistant: "What's in my cart?"
Agent: Uses `get_cart` to retrieve cart contents and reads them aloud

Messaging Bot: Customer sends product image
Agent: Uses `search_products` to find similar products and suggests alternatives

Product Information Services

Build intelligent product information services that provide detailed specifications and comparisons:

Customer: "Tell me about this product's specifications"
Agent: Uses `get_product` to retrieve comprehensive product details and presents them conversationally