On this page
Updated September 2026
Build an MCP server when agents repeatedly need live access to your product's data or actions, that access should work across compatible AI clients, and the workflow is valuable enough to operate as a production product surface. If static knowledge, a repeatable procedure, one controlled integration, or browser use solves the job, a simpler interface may be better.
The core principle is simple: MCP is a product interface, not an API wrapper.
What MCP adds
Model Context Protocol ↗ standardizes how AI applications connect to external tools and data. A server can expose focused capabilities that compatible hosts discover and invoke without each host learning a bespoke integration.
That creates leverage when all three conditions are true:
- The agent needs current data or must perform an action.
- The same capability should be available across more than one compatible host.
- The workflow is important enough to secure, document, observe, support, and improve.
MCP does not remove the underlying product work. You still own authorization, tool design, errors, reliability, data handling, versioning, and the quality of the user's outcome.
MCP server versus API, skill, context, and browser use
| Interface | Best when | Main advantage | Main tradeoff |
|---|---|---|---|
| MCP server | Agents need live tools or data across compatible hosts | Standard discovery and invocation | New production surface to secure and operate |
| Direct API integration | One application controls the complete stack | Precise control and less protocol surface | Rebuilt for each client or agent |
| Agent skill | The value is instructions, a procedure, or reusable expertise | Lightweight distribution and progressive context | Execution and access depend on the host, bundled scripts, and available tools |
| Static context | Knowledge changes slowly and fits the task | Simplest architecture | Staleness and limited interaction |
| Browser automation | No suitable API exists and a human workflow must be reproduced | Fast access to an existing interface | Fragile, slower, and harder to secure |
OpenAI documents MCP tools alongside built-in tools and custom function calls in the Responses API ↗. Claude Code documents plugins that can package skills and MCP server configuration together in its plugin system ↗. Distribution options are expanding, but the interface decision should still begin with the job.
The MCP Readiness Test
Answer these five questions before opening an SDK.
1. Is the data or action live?
If a monthly documentation export is enough, use static context or retrieval. MCP becomes more useful when the agent needs current state, scoped access, or an action whose result changes over time.
2. Is the workflow repeated?
One impressive demo is not demand. Look for a job users perform often enough that a stable tool interface will save time, reduce mistakes, or create new value.
3. Does cross-client access matter?
If the capability will exist inside one product you control, direct function calling may be simpler. MCP earns its cost when the same server should work across compatible assistants, IDEs, or internal agents.
4. Can you define a safe permission boundary?
List what the agent may read or change, who authorizes it, which operations need confirmation, and how you will prevent one tool from becoming a universal back door. If the answer is vague, the server is not ready.
5. Can you observe and support the outcome?
You need to know which tools are used, where workflows fail, who is affected, and whether the intended result happened. If the product cannot distinguish a completed job from a successful request, it will be difficult to improve after launch.
Passing four questions is not an automatic yes. Failing the safety or support question is usually a no until the gap is resolved.
When not to build an MCP server
The content is static
A product manual, coding standard, or repeatable checklist may fit an agent skill. Do not create network, authentication, and runtime dependencies for information that can ship as versioned files.
Only one controlled agent needs the function
Use the direct API or function-calling interface when one application owns the caller, permissions, and release cycle. Add MCP later if interoperability becomes a real requirement.
The workflow has no validated user
An MCP directory listing is not a business case. Validate the job with real target users before committing to ongoing compatibility and support.
The underlying action is unsafe or ambiguous
If you cannot bound authorization, side effects, confirmation, and recovery, expose a read-only or narrower capability first.
The plan is to expose every endpoint
A generated one-to-one wrapper often produces too many tools, overlapping descriptions, inconsistent errors, and excessive permissions. It transfers API complexity to the model.
Design tools around agent jobs
An agent-friendly tool should have one clear responsibility, a description that distinguishes it from nearby tools, a bounded input, a predictable result, and errors that let the caller recover honestly.
Prefer a small job-oriented surface:
find_accountsummarize_recent_activitycreate_sales_brief
over a mechanically generated catalog of every account, activity, document, and template endpoint.
The right granularity depends on the decision boundary. A coarse tool can hide important choices and permissions. A very fine tool set can produce long, fragile call chains. Test the surface with the models and clients your users actually run.
Validate the business case before the platform project
- Name the target user and repeated job.
- Observe how the job is completed today.
- Identify the step that requires live data, action, or cross-client access.
- Prototype the smallest read-only tool set.
- Test discovery and execution in two representative clients.
- Measure completion, time saved, errors, and repeat use.
- Interview users after they have tried it more than once.
- Add write actions only when their value and controls are clear.
The evidence should support a sentence such as: "Customer engineers use the server weekly to assemble an incident brief from three live systems, and the completed brief reduces manual investigation." "We received 10,000 calls" is not equivalent.
If you build an MCP server, how do you know whether it is working?
Server logs can usually tell you which tools were called, how long requests took, which errors occurred, whether authentication worked, and what the immediate request status was. Those are necessary operating signals.
They do not necessarily tell you what the user was trying to accomplish, why the agent selected that path, whether the final response solved the request, whether repeated calls were useful work or retries, which capabilities are missing, or whether the conversation contains product feedback or commercial interest.
MCP adoption is not the same thing as MCP tool-call volume. A busy server can represent genuine value, but it can also represent poor tool selection, irrelevant searches, unnecessary multi-step workflows, retries, loops, or unsupported requests.
The useful unit of analysis is the full journey and outcome, not the individual tool call. Connect operational evidence to attempted jobs, complete paths, affected users, and the strongest available outcome. Then compare the pattern across sessions instead of treating every successful call as a successful product experience.
Flowlines MCP observability is designed for this behavioral layer. The production MCP observability guide explains the operating model, and the MCP analytics guide turns it into a product scorecard.
Measure success at three levels
Infrastructure and tool reliability
Track availability, latency, authentication, failures, retries, version adoption, and telemetry health. These metrics establish whether the interface can be trusted.
Agent behavior
Track tool selection, unnecessary switching, repeated calls, path length, recovery, and unsupported completion claims. This explains how models use the interface.
User and business outcomes
Track unique adopters, returning usage, completed jobs, outcome coverage, affected users, time saved, product demand, retention, and relevant business events.
Use the MCP analytics framework to build the scorecard and the MCP observability guide to connect it to operational evidence.
Tool success versus task success
Consider a recruiting server. The agent successfully searches candidates, reads one profile, and creates a shortlist. The tool calls all succeed. The user asked for candidates in France with five years of a specific experience, but the shortlist ignores the location constraint.
The infrastructure level is healthy. The tool level is healthy. The task outcome is not.
Review the complete path through five questions:
- Intent: What did the user ask to achieve?
- Execution: Which tools and decisions formed the path?
- Interpretation: Did the agent understand the results and constraints?
- Outcome: Was the requested artifact or action produced correctly?
- Aftermath: Did the user accept, correct, repeat, or abandon the work?
This framework turns a protocol integration into a product you can operate.
What changed in the 2026 MCP specification
The 2026-07-28 MCP release ↗ introduced a stateless protocol core, moved long-running tasks into an extension, expanded authorization work, and deprecated several earlier protocol features. Current Tier 1 SDKs support the revision according to the official release post. Older clients and compatibility modes still exist, so check the revision your deployment actually uses.
Two product implications matter:
- Do not base product analytics on a protocol session identifier that modern requests no longer carry.
- Keep SDK and client compatibility visible because the transition includes breaking changes.
The protocol becoming easier to scale does not make the user journey stateless. Your observability model still needs to represent multi-request work when the application has a permitted correlation mechanism.
Skills, plugins, and MCP can work together
A skill can teach an agent how to complete a task. An MCP server can supply the live tools and data. A plugin can distribute the skill, MCP connection, and supporting components as one package where the host supports that model.
Use the smallest combination that solves the user job:
- Skill only for a repeatable procedure over local or already available tools.
- MCP only for a clean live capability that agents can discover directly.
- Skill plus MCP when the workflow benefits from both instructions and live tools.
- Plugin when you need a versioned distribution bundle for a supported host.
For a CRM integration, the MCP might expose account lookup, recent activity, and brief creation. A skill can define the account-review procedure: confirm the account, check recent changes, cite missing evidence, then prepare the brief. The plugin bundles that workflow with its connection. The product users adopt is "prepare my account review," not a catalog of endpoints.
Keep these responsibilities separate. Updating the procedure should not require expanding permissions; adding a new write tool should trigger a fresh safety review. When the workflow is ready, use the OpenAI submission guide or Claude marketplace guide for the distribution step.
Launch checklist
- A named target user and repeated job
- Evidence that live or cross-client access adds value
- A small, non-overlapping tool surface
- Read and write permissions defined separately
- Authentication, authorization, confirmation, and recovery tested
- Clear errors and bounded results
- Compatibility tests for representative clients and protocol versions
- OpenTelemetry-compatible operational telemetry
- A reviewed privacy and retention boundary
- Tool, session, behavior, and outcome metrics
- Source sessions for recurring issues
- A release and rollback process
- Ownership for support and deprecations
- A feedback path and roadmap rule
Where Flowlines fits
Flowlines MCP observability helps teams operate the server after launch. It shows how tools are adopted, what use cases people attempt, which paths recur, where outcomes are missing, who is affected, and which source sessions explain the pattern. The product is complementary to infrastructure monitoring and trace storage.
If the decision is yes, use the OpenTelemetry instrumentation guide. If the decision is still unclear, run the readiness test with one concrete workflow rather than debating the protocol in the abstract.
Primary sources and further reading
Frequently asked questions
When should a company build an MCP server?
Build one when agents repeatedly need live access to product data or actions, the interface should work across compatible AI clients, and the workflow is valuable enough to operate as a production product surface.
When should you not build an MCP server?
Do not build one when static context, an agent skill, a direct API integration, or browser automation solves the need with less operational and security burden. Avoid an MCP server for unvalidated demand or a thin wrapper over every API endpoint.
Is an MCP server just an API wrapper?
No. A useful MCP server is an agent-facing product interface. It exposes a focused set of tools with clear boundaries, predictable results, appropriate authorization, and workflows that models can use reliably.
What is the difference between MCP and an API?
An API is a general software interface for developers and services. MCP standardizes how compatible AI hosts discover and invoke tools and access context. An MCP server can call existing APIs, but should present an agent-friendly surface rather than mirror them mechanically.
What is the difference between an MCP server and an agent skill?
An MCP server provides live tools and data through a protocol. A skill packages instructions, procedures, and supporting knowledge that help an agent perform a task. A skill may call an MCP server, but static or procedural work may need only the skill.
Should every API endpoint become an MCP tool?
No. Expose the smallest coherent set of agent-friendly tools needed for validated jobs. Large tool catalogs can create ambiguity, unnecessary permissions, and poor selection behavior.
How do you validate demand for an MCP server?
Interview target users, identify repeated agent workflows, test the job with a narrow prototype, measure repeat use and completion, and confirm that cross-client distribution or live action access materially improves the experience.
How do you measure whether an MCP server is successful?
Measure infrastructure and tool reliability, agent behavior, user adoption, workflow completion, outcome quality, retention, unmet demand, and business impact. Tool-call volume alone is insufficient.
How does Flowlines help MCP product teams?
Flowlines shows how MCP servers are used across tools, permitted identities, use cases, journeys, outcomes, recurring failures, feedback, and custom product or commercial signals.