From 8ad7ed6f4ed237fce02f92c8b9e551cac1b46be6 Mon Sep 17 00:00:00 2001 From: "talas-discord[bot]" <255758376+talas-discord[bot]@users.noreply.github.com> Date: Sun, 15 Feb 2026 07:30:11 +0000 Subject: [PATCH 1/6] =?UTF-8?q?Fix=20naming=20inconsistencies:=20"Link=20A?= =?UTF-8?q?PI"=20=E2=86=92=20"Link"=20and=20"Query=20API=20MCP"=20?= =?UTF-8?q?=E2=86=92=20"Query=20MCP"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rename "Link API" to "Link" throughout docs (CLAUDE.md, AGENTS.md, changelog.mdx) - Reflects that Link is primarily a hosted consent flow, not an API-first service - Keeps API URLs unchanged (link.emergedata.ai remains) - Standardize "Query API MCP" to "Query MCP" across all AI docs - Distinguishes MCP server ("Query MCP") from HTTP API ("Query API") - Aligns with "Docs MCP" naming pattern for consistency - Updated files: ai/mcp-query-setup.mdx, ai/mcp-query-tools.mdx, ai/overview.mdx, ai/mcp-docs-setup.mdx, ai/examples.mdx, CLAUDE.md These changes improve clarity and accuracy of product naming. --- CLAUDE.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 09f058b..eb00ac6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,7 +1,7 @@ # Emerge API Documentation ## Project overview -Documentation for Emerge API - a privacy-first API for accessing consented user data. The project includes Link API (consent collection) and Query API (data retrieval). +Documentation for Emerge API - a privacy-first API for accessing consented user data. The project includes Link (consent collection) and Query API (data retrieval). ## Technical stack - Format: MDX files with YAML frontmatter @@ -108,7 +108,7 @@ description: Concise summary for SEO/navigation ``` ## File organization -- `/link/*.mdx` - Link API guides (overview, authentication, create-link, callbacks, webhooks) +- `/link/*.mdx` - Link guides (overview, authentication, create-link, callbacks, webhooks) - `/query/*.mdx` - Query guides (overview, pagination, event-categories, data-schema) - `/ai/*.mdx` - Ship with MCP docs (overview, mcp-docs-setup, mcp-query-setup, mcp-query-tools, contextual-menu, examples) - `/ai-tools/*.mdx` - AI tool-specific setup guides (claude-code, cursor, windsurf) [Note: Directory exists in git but not filesystem - may be template content] @@ -175,7 +175,7 @@ mint validate | Ad Interactions | `/v1/sync/get_ads` | `/v1/ads` | Ad clicks and views | | Receipts | `/v1/sync/get_receipts` | `/v1/receipts` | Purchase receipts with items and brands | -### Link API endpoints +### Link endpoints - `POST /configs` - Create/update consent flow configuration (required: config_name, company_name, logo_url, privacy_policy_url, is_default; optional: webhook_url, flow_config) - `GET /consent/status/{uid}` - Returns `sub`, `client_id`, and provider-level `consents[]` - `GET /export/status/{uid}` - Returns provider-level readiness in `sources[]` @@ -203,7 +203,7 @@ mint validate - "event_id" - Integer type in Query API responses (not string) ## API domains -- Link API: https://link.emergedata.ai +- Link: https://link.emergedata.ai - Query API: https://query.emergedata.ai - Dashboard: https://dashboard.emergedata.ai - MCP Server: https://docs.emergedata.ai/mcp (AI tool integration - updated from emerge.mintlify.dev) From 24f6f91c25994a652d733b52ed7f3a53478d9f89 Mon Sep 17 00:00:00 2001 From: "talas-discord[bot]" <255758376+talas-discord[bot]@users.noreply.github.com> Date: Sun, 15 Feb 2026 07:30:35 +0000 Subject: [PATCH 2/6] Update AGENTS.md and changelog.mdx - rename "Link API" to "Link" --- AGENTS.md | 2 +- changelog.mdx | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c9b4352..e9cfba8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -74,7 +74,7 @@ When answering questions about Emerge: ## API domains -- Link API: https://link.emergedata.ai +- Link: https://link.emergedata.ai - Query API: https://query.emergedata.ai - Dashboard: https://dashboard.emergedata.ai diff --git a/changelog.mdx b/changelog.mdx index 6310064..2189add 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,7 +5,7 @@ description: "API updates and documentation changes" ## v0.0.11 (2026-02-12) -**Link API:** +**Link:** - Updated webhook payload contract to v2 (`sources[]` + `client_id` in payload) - Updated webhook headers (`X-Signature`, `X-Webhook-Version: 2.0`, `X-Attempt-Number`, `Idempotency-Key`) - Added `client_id` to `GET /consent/status/{uid}` response @@ -22,7 +22,7 @@ description: "API updates and documentation changes" ## v0.0.10 (2026-01-28) -**Link API:** +**Link:** - Removed `flow_version` parameter (deprecated) - Use `flow_config` for custom branding configurations From a9c5a9fac24aa98715b2018c8ddc25ed6c0cbdbc Mon Sep 17 00:00:00 2001 From: "talas-discord[bot]" <255758376+talas-discord[bot]@users.noreply.github.com> Date: Sun, 15 Feb 2026 07:31:03 +0000 Subject: [PATCH 3/6] Update ai/mcp-query-setup.mdx - standardize to "Query MCP" --- ai/mcp-query-setup.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/ai/mcp-query-setup.mdx b/ai/mcp-query-setup.mdx index fd9ee1f..e7be64c 100644 --- a/ai/mcp-query-setup.mdx +++ b/ai/mcp-query-setup.mdx @@ -3,7 +3,7 @@ title: "MCP Query Setup" description: "Connect AI tools to query consented user data via MCP" --- -The Query API MCP server gives AI agents (Claude, Cursor, VS Code) secure access to consented user data. Instead of making direct HTTP calls, AI tools use the Model Context Protocol with session-based credentials. +The Query MCP server gives AI agents (Claude, Cursor, VS Code) secure access to consented user data. Instead of making direct HTTP calls, AI tools use the Model Context Protocol with session-based credentials. **Different from Docs MCP**: This server queries **user data**. For documentation search, see [Docs MCP Setup](/ai/mcp-docs-setup). @@ -84,7 +84,7 @@ https://mcp.emergedata.ai/mcp 2. Go to **Settings** → **Connectors** 3. Click **Add custom connector** 4. Enter configuration: - - **Name**: Emerge Query API + - **Name**: Emerge Query MCP - **URL**: `https://mcp.emergedata.ai/mcp` 5. Add connection parameters: ``` @@ -137,7 +137,6 @@ https://mcp.emergedata.ai/mcp ``` @Emerge Query Show me search patterns for the last month ``` - Cursor will: 1. Query the MCP server 2. Receive structured data From ad1e45f1690f3f7991b810e23ef5a99bdd471a15 Mon Sep 17 00:00:00 2001 From: "talas-discord[bot]" <255758376+talas-discord[bot]@users.noreply.github.com> Date: Mon, 16 Feb 2026 12:16:24 +0000 Subject: [PATCH 4/6] =?UTF-8?q?Fix=20naming=20inconsistencies:=20"Link=20A?= =?UTF-8?q?PI"=20=E2=86=92=20"Link"=20and=20"Query=20API=20MCP"=20?= =?UTF-8?q?=E2=86=92=20"Query=20MCP"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index eb00ac6..d9e3b03 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -175,7 +175,7 @@ mint validate | Ad Interactions | `/v1/sync/get_ads` | `/v1/ads` | Ad clicks and views | | Receipts | `/v1/sync/get_receipts` | `/v1/receipts` | Purchase receipts with items and brands | -### Link endpoints +### Link API endpoints - `POST /configs` - Create/update consent flow configuration (required: config_name, company_name, logo_url, privacy_policy_url, is_default; optional: webhook_url, flow_config) - `GET /consent/status/{uid}` - Returns `sub`, `client_id`, and provider-level `consents[]` - `GET /export/status/{uid}` - Returns provider-level readiness in `sources[]` @@ -203,7 +203,7 @@ mint validate - "event_id" - Integer type in Query API responses (not string) ## API domains -- Link: https://link.emergedata.ai +- Link API: https://link.emergedata.ai - Query API: https://query.emergedata.ai - Dashboard: https://dashboard.emergedata.ai - MCP Server: https://docs.emergedata.ai/mcp (AI tool integration - updated from emerge.mintlify.dev) From fb67f14a0566c65ebd84f7ae49644f68e33ba168 Mon Sep 17 00:00:00 2001 From: "talas-discord[bot]" <255758376+talas-discord[bot]@users.noreply.github.com> Date: Mon, 16 Feb 2026 12:16:46 +0000 Subject: [PATCH 5/6] Update AGENTS.md and changelog.mdx From e55efee708837393bff39616e5638f762594ff07 Mon Sep 17 00:00:00 2001 From: "talas-discord[bot]" <255758376+talas-discord[bot]@users.noreply.github.com> Date: Mon, 16 Feb 2026 12:17:39 +0000 Subject: [PATCH 6/6] Update ai/mcp-query-setup.mdx with "Query MCP" naming --- ai/mcp-query-setup.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/ai/mcp-query-setup.mdx b/ai/mcp-query-setup.mdx index e7be64c..54a13c3 100644 --- a/ai/mcp-query-setup.mdx +++ b/ai/mcp-query-setup.mdx @@ -137,6 +137,7 @@ https://mcp.emergedata.ai/mcp ``` @Emerge Query Show me search patterns for the last month ``` + Cursor will: 1. Query the MCP server 2. Receive structured data @@ -218,7 +219,7 @@ The MCP server exposes 5 tools that map 1:1 to Query API sync endpoints: | `get_ads_data` | `/v1/sync/get_ads` | Ad interactions | | `get_receipts_data` | `/v1/sync/get_receipts` | Purchase receipts | -See [MCP Query Tools](/ai/mcp-query-tools) for detailed parameter and response documentation. +See [Query MCP Tools](/ai/mcp-query-tools) for detailed parameter and response documentation. ## Response Format