mcp-data-platform-v1.89.0

This release makes knowledge-page references work end to end and surfaces canonical knowledge to agents wherever they touch an entity. Pages now capture the entities they reference, trace back to the insights they were synthesized from, and appear in the three places an agent actually looks: search, connection listings, and entity tool responses.

Knowledge-page references, fixed end to end (#678)

Knowledge pages referenced datasets and connections in their prose, but none of that was captured, traced, or rendered. This release closes all of it:

• References are created on promotion. apply_knowledge now scans a page body for mcp:/urn: references and stores them, on both create and update, the same way the portal save path does. Previously only the source insight's references carried, so an agent-promoted page with inline links captured none of them. Rollback re-derives them from the restored body.
• Source-insight lineage. A new "Synthesized from" panel (and GET /api/v1/portal/knowledge-pages/{id}/lineage endpoint) traces a page back to the captured insights it was promoted from, deduped across promotions, drained insights skipped. It is reviewer-facing: the endpoint is gated to apply_knowledge holders because it exposes raw insight text and the capturer's identity.
• Tags render on the page view (previously only on the edit form).
• Bare mcp:/urn: tokens render as entity chips in page bodies, not raw URN text; code spans and existing markdown links are left untouched.

Agent cross-enrichment: knowledge about entities and connections (#634)

The reverse lookup (the pages that reference a target) is now wired into the three agent-facing surfaces, so the business and domain knowledge about an entity appears where the agent already works, with no extra call:

• search(entity_urns=[...]) returns the knowledge pages that reference each entity, merged and de-duplicated with the text-relevance results. It covers datasets (urn:li:dataset:...) and connections (mcp:connection:(kind,name)) alike.
• list_connections carries, per connection, a knowledge_page_count and a bounded sample of the pages that document it.
• Entity tool responses (for example datahub_get_entity) now carry a bounded knowledge_pages block, appended by the semantic enrichment middleware alongside the existing memory context.

The cross-enrichment is bounded so it never bloats a response: at most ten distinct entity URNs are looked up per result, and at most five pages are returned per entity. The full total is still reported via knowledge_page_count on the connection surface.

Internal and architecture

• New pkg/connview package, holding the list_connections view build and its knowledge enrichment behind narrow capabilities, decomposed out of pkg/platform to stay within the package size budget. The tool's JSON shape is unchanged.
• knowledgepage.PagesForURNs, a shared reverse-lookup helper (parse, reverse-lookup, dedup by page id, cap) used by the enrichment surfaces.
• knowledge.PageSearcher exported as the knowledge-page provider capability (relevance search plus reverse lookup).
• Documentation updated: the cross-enrichment overview, docs/llms.txt, and docs/llms-full.txt.

Issues closed

• #678 (knowledge-page references broken end to end: promotion, lineage, tags, chips)
• #634 (agent cross-enrichment for entities and connections)

Pull requests

• #679 fix(knowledge): create page refs on promotion, surface insight lineage, render tags and bare-token chips
• #680 feat(knowledge): surface knowledge pages about entities and connections to agents
• #681 feat(knowledge): enrich entity tool responses with the pages that document them

Full changelog: v1.88.1...v1.89.0

Installation

Homebrew (macOS)

brew install txn2/tap/mcp-data-platform

Claude Code CLI

claude mcp add mcp-data-platform -- mcp-data-platform

Docker

docker pull ghcr.io/txn2/mcp-data-platform:v1.89.0

Verification

All release artifacts are signed with Cosign. Verify with:

cosign verify-blob --bundle mcp-data-platform_1.89.0_linux_amd64.tar.gz.sigstore.json \
  mcp-data-platform_1.89.0_linux_amd64.tar.gz