Skip to main content
Architecture10 min read

201 - Anatomy of a Plexara MCP

201 shows what is actually in the box on a Plexara server: the tools, resources, prompts, memory, and knowledge the agent sees. This lesson is the map.

What you will take away from this lesson

The 100 series closed with the argument that MCP is an application layer, not a thin wrapper over APIs. This lesson opens the application. What is actually inside a Plexara MCP server when you connect your client to one? Which parts are standard MCP and which parts are Plexara-specific? And where does the rest of the 200 series take each piece?

This is a map lesson, not a deep dive. Every subsystem introduced here has its own dedicated lesson later. If anything in the map looks interesting, follow the link in its row and come back.

Learning Objectives

  1. 01Know what is actually inside a Plexara MCP server: the base MCP primitives (tools, resources, prompts) and the Plexara-specific subsystems that layer on top.
  2. 02Use this lesson as a map for the rest of the 200 series: each primitive has its own dedicated lesson where it gets covered in depth.
  3. 03Explain why Plexara sits at the application-server end of the MCP spectrum (from 110) rather than being a thin wrapper over data-source APIs.
  4. 04Stop conflating MCP primitives with Plexara subsystems: memory and knowledge are implemented using primitives, but they are first-class subsystems for a user.
  5. 05Recognize the one tool every session loads first (platform_info) and why it is the starting point for the entire discover-query-enrich workflow.

Where we are in the curriculum

The 100 series built the foundation that every lesson in this series assumes. Each title below is a direct link back; the index card links to the 100-series landing page.

The 200 series narrows focus to one specific MCP server. It is not a survey of MCP implementations in general. It is a guided tour of what Plexara advertises to an agent, organized the way a power user should think about the surface.

100 Series: the foundation

Open index

If a term in this lesson looks unfamiliar, back up to the 100 series. The 200 series assumes that mental model. Every row above is a direct link.

The anatomy of a Plexara MCP

A Plexara MCP server advertises seven distinct kinds of things to a connected client. Three of them are base MCP primitives every compliant server has. Four of them are Plexara-specific subsystems built on top. You do not need to memorize this table; the map below exists so that when a later lesson refers to "memory" or "the knowledge pipeline" or "the semantic enrichment layer," you already know where it fits.

What is in a Plexara MCP (and where each piece is covered)

  • Functions the agent can call: datahub_search, trino_query, memory_recall, save_artifact, and dozens more. The core mechanism through which the agent reaches your data.

  • Resources

    Base MCP

    URI-addressable reference material the server exposes to the client: brand assets, templates, sample documents, reference data that sits outside the catalog and outside memory.

  • Prompts

    Base MCP

    Named, reusable parameterized instructions the server advertises. Plexara ships a default library and lets administrators and knowledge curators add more.

  • Semantic enrichment

    Plexara subsystem

    Tool results come back with catalog metadata (descriptions, tags, owners, column detail, glossary terms, PII flags) already attached, deduplicated within a session so the same table is not re-enriched on repeat queries.

  • Memory

    Plexara subsystem

    A per-user, cross-session recall layer. Survives past the context window. Stored as semantically searchable records; the agent is prompted to call memory_recall when prior-session context might help, so relevant memories can surface without the user naming them by hand.

  • Knowledge

    Plexara subsystem

    An organization-wide documentation layer fed by an admin-reviewed insights pipeline. User corrections and agent observations become catalog documentation after review.

  • Governance

    Plexara subsystem

    Persona-based tool and connection filtering, default-deny posture, read-only pinning, bucket prefix scoping, workflow gating, and per-call audit. Enforced at execution time, not at catalog time.

The three blue rows are the base MCP primitives every MCP server has. The four copper-badged rows are the subsystems Plexara adds on top using those primitives, which together make Plexara an application server (the category established in 110) rather than a thin wrapper.

Base primitives vs application subsystems

The distinction between the top three rows and the bottom four is load-bearing. The 110 lesson drew a spectrum from thin-wrapper MCP servers to full application servers. The difference, concretely, is everything below the line in the map above. A thin wrapper exposes tools, resources, and prompts. An application server uses those primitives to build subsystems that do useful, coordinated work: enriching returned data with catalog context, recalling memories from prior sessions, promoting observations into organization-wide documentation, and enforcing governance at the point a tool is invoked.

How the pieces compose in one session

A single question, "How are ACME Corp sales doing in the Southwest region?", touches almost every row of the map. The agent consults the tool list (tools). The server gates everything behind platform_info and returns the operating manual along with the prompt library (resources and prompts). The agent calls datahub_search, and the response comes back with semantic enrichment attached automatically (tools + enrichment). Governance has already filtered out any tools or connections this persona is not allowed to use (governance). The agent looks in memory to see whether the user had a preferred definition of "sales" in earlier sessions (memory). It calls trino_query; the returned table metadata is enriched but deduplicated against what was sent earlier in the session (enrichment). The answer is formed and, if a user correction surfaces, routed toward the admin review pipeline for possible promotion to organization-wide documentation (knowledge).

The user experiences this as a single fluid answer. The map is what that fluid answer decomposes into when you look at it carefully.

Every session starts in the same place

Before any of the subsystems engage, the session passes through a single gate. Until platform_info has been called, every other tool refuses with a structured error. This is a deliberate design choice and it is the subject of the next lesson.

Where this leads

The rest of the 200 series walks through the subsystems one at a time, starting with the gate.

Key terms

Six terms cover the vocabulary you will need as the rest of the 200 series unfolds. "Primitive" vs "subsystem" is the distinction worth keeping sharp because it maps directly to the division in the anatomy map above.

Key Terms

Plexara MCP server
The MCP server a customer's client connects to. An application-server-class MCP (in the sense established in 110) that layers semantic enrichment, memory, knowledge, and governance on top of the base MCP primitives.
Primitive
One of the three things an MCP server can advertise to a client: tools, resources, or prompts. Standard across all MCP implementations.
Subsystem
A Plexara-specific feature built on top of the base primitives. Semantic enrichment, memory, knowledge, and governance are the four subsystems a power user interacts with day to day.
platform_info
The mandatory first tool call in every Plexara session. Returns the operating manual for the deployment, including toolkits, feature flags, the prompt library, and customer-specific agent_instructions. Every other tool is gated behind it.
Toolkit
A named grouping of related tools in a Plexara deployment (for example, the DataHub toolkit, the Trino toolkit, the S3 toolkit). platform_info reports which toolkits are enabled for the current session.
Persona
A named role that determines which tools and which connections a caller can see and invoke. Enforced at execution time. Detailed in 207.