Introduction

Wonderflow gives you Voice of Customer (VoC) data—feedback, ratings, and analytics—from one place. You can store data from your touchpoints (CRMs, surveys, reviews) in our data lake and retrieve KPIs and insights for your apps, BI tools, or AI workflows.

Two ways to connect to Wonderflow

  • use our REST API when you’re building or automating
  • use our MCP connector when you want to query analytics in natural language from an AI assistant or IDE

🔗 REST API

What it is

A standard HTTP REST API. Your application sends authenticated requests (GET, POST, etc.) to our endpoints and receives structured JSON responses. You have full control over each request: you choose the endpoint, parameters, and how to handle the response. The API covers every Wonderflow capability—storing and retrieving feedback, analytics, products, votes, and user management.

How it works

You obtain an API key and secret (from Wonderflow), exchange them for a Bearer token via our token endpoint, then include that token in the Authorization header of every request. Tokens are valid for 30 days. Our API follows standard REST conventions and is documented in OpenAPI; you can use the in-portal Playground to try calls without writing code.

🏆 Best for

  • 🏗️ Building applications, dashboards, ETL pipelines, or internal tools
  • 🔌 Integrating VoC data into CRMs, BI platforms, or other systems
  • ⚙️ Automating workflows where you need full control over requests and responses

REST API Portfolio

🤖 MCP connector

What it is

The Model Context Protocol (MCP) is an open standard (spearheaded by Anthropic and the developer community) that lets AI applications connect to external data and tools. In MCP, clients (e.g. Cursor, Claude Desktop, or other IDEs and chat apps) talk to servers that expose resources (data) and tools (actions). The AI uses the protocol to fetch live context from servers instead of relying only on pasted docs or static knowledge—so you can ask in plain language and get answers backed by real Wonderflow data.

Our MCP connector is an MCP server that exposes your Wonderflow catalog: product insights, feedback KPIs, sentiment scores, prices, votes, and trends. MCP-compatible clients connect to this server and can query your VoC data in natural language—no REST calls or code on your side. Authentication uses your existing Auth0 login (the same credentials you use for the Wonderboard).

How it works

You configure your MCP client (e.g. Cursor, Claude Desktop, Gemini CLI, Microsoft Copilot Studio, ChatGPT, or another MCP-enabled tool) with the Wonderflow MCP server URL. When you ask a question in chat (“What’s the sentiment index for brand X by country?”), the client uses MCP to call the right tool on our server; we return the analytics data, and the AI surfaces the answer. No HTTP calls or code on your side, the protocol handles everything.

🏆 Best for

  • 💬 Exploring analytics in chat or inside your IDE without writing API code
  • 🔍 Ad-hoc queries and quick checks on KPIs, trends, or product performance
  • 🤖 Feeding live Wonderflow insights into AI-driven workflows and decision support
  • 👥 Non-technical team members who want catalog insights without learning the REST API

MCP Tools Portfolio

Supported clients

Any client that supports OAuth 2.1 + Streamable HTTP should work. Tested clients:

📖 For the full MCP Connector documentation — authentication, setup guides, and tools reference — visit the MCP Connector section.

Need help? Contact our team—we’re here to get you up and running with REST or MCP.