Welcome to the Wonderflow cloud
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
Get Analytics
Data-driven insights for decision-making and planning.
Get Feedback
Retrieve user feedback for customer insights.
Get Votes
User ratings and preferences for product and popularity analysis.
Get Product list
Product catalog details for seamless integration.
Push Feedback
Submit feedback programmatically to the data lake.
Manage Users
User account management.
🤖 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
Discover Topics
Find topics in your catalog using semantic search.
Discover Metadata
List available metadata fields or search for field values.
Get Data Types
List all data types available in the current catalog.
Get Configuration
Retrieve channels, categories, and divisions.
Feedback Analytics
Sentiment, NPS, pros/cons, ratings, and more across any dimension.
Price Analytics
Price trends and comparisons across channels and regions.
Votes Analytics
Vote counts and ratings broken down by any dimension.
Find Products
Search the catalog by brand, category, division, or custom group.
Search Reviews
Semantic search across customer reviews with rich filtering.
List Catalogs
List all catalogs available to your user.
Switch Catalog
Switch the active catalog from the chat using its scope ID (admins).
Supported clients
Any client that supports OAuth 2.1 + Streamable HTTP should work. Tested clients:
Claude Desktop
Connect via the built-in Connectors UI.
ChatGPT
Add the connector as a custom MCP plugin in ChatGPT settings.
Microsoft Copilot Studio
Add the connector to your Copilot Studio agents with a manual OAuth setup.
Cursor
Connect via mcp-remote in MCP settings.
Gemini CLI
Connect via settings.json with OAuth config.
MCP Inspector
Debug and explore the protocol tools.
📖 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.