What an endpoint-first build might expose
- GET /inventory
- GET /inventory/{id}
- GET /availability
- POST /quotes
- PATCH /quotes/{id}
- Internal IDs and backend validation errors
Custom MCP Server Development
KNWN turns selected product capabilities into clear, authenticated MCP tools. We design the tool surface, connect your systems, preserve permissions, control write actions, test real tasks, deploy the server to your infrastructure, and hand over the complete implementation.
For SaaS products, marketplaces, operational systems, and businesses with a stable source of truth.
A model does not need your entire API. It needs a small set of tools whose names, descriptions, inputs, permissions, and results make the intended task obvious.
KNWN starts with the user request and works backward. We decide what the tool should accomplish, what information it needs, what the user is allowed to do, which system owns the result, and how the action should fail. Only then do we map it to your API or backend.
A generated wrapper can expose an endpoint. A useful MCP server exposes a job the user actually wants to complete.
From endpoint list to user workflow
find_available_options
Finds items that match the user's requirements and are available for the requested time and location.
create_quote_draft
Creates a reviewable draft using the selected items and customer details without committing the final transaction.
confirm_quote
Commits the approved quote only after the user has reviewed the summary and confirmed the action.
The workflow version gives the model fewer choices, gives the user clearer control, and gives your backend a cleaner boundary.
Search and filter products, inventory, services, listings, documents, or account records using natural requests mapped to your actual data model.
Retrieve availability, status, eligibility, pricing, schedules, balances, or other information that must come from the current source system.
Prepare quotes, reservations, tickets, reports, orders, changes, or other work for review before anything is committed.
Create or update records using the signed-in user's identity, permissions, and tenant context.
Execute the final action only after the required summary, confirmation, validation, and policy checks have passed.
The work behind a reliable tool call
We identify the requests the server should handle, group related actions, remove overlap, and define when the model should and should not use each tool.
We design inputs the model can populate reliably and results that remain useful in conversation, in logs, and in an optional interface.
We connect the user's identity to the permissions enforced by your product. Authentication proves who the user is. Authorization still decides which data and actions that user may access.
We classify tools as read, draft, or committed write actions and add confirmation, validation, idempotency, and recovery behavior where the risk requires it.
We normalize upstream errors, make failures useful to the model, preserve operational detail in logs, and define what should be retried, corrected, or escalated.
We test direct requests, indirect requests, requests that should not trigger a tool, invalid inputs, permission failures, dependency failures, and complete workflow outcomes.
The final list is defined around the approved workflow. We do not inflate the project by exposing tools nobody needs.
KNWN deploys to the client-controlled environment agreed in the scope. Your team receives the repository, infrastructure configuration, environment requirements, tests, evaluation scenarios, and operating documentation needed to own the implementation.
Not enough on its own:
Scope is shaped by:
Unless the proposal explicitly includes it, an MCP server engagement does not include:
There is no universal correct number. The server should have the smallest set that can complete the approved workflows without forcing unrelated actions into one vague tool. We decide based on tool overlap, permissions, user intent, and evaluation results rather than a target count.
Yes. That is often the fastest path when the API is stable and already enforces the right business rules. We audit it before scope, because gaps in authentication, validation, or write behavior may need to be resolved first.
Yes, when the product has a reliable tenant model. We map the authenticated identity and granted scopes into the tenant boundaries already enforced by your system, then test for cross-tenant access failures.
Potentially, but MCP protocol compatibility does not guarantee feature parity. Transport, authentication, tool annotations, UI rendering, account policy, and host behavior can vary. Every target client included in scope is tested separately, and unsupported capabilities are documented rather than presented as portable.
Yes, when a visual component makes the workflow easier to inspect, compare, edit, confirm, or navigate. The underlying tools should still return useful structured results so the workflow is not dependent on one interface.
KNWN hosting is not required. The production server can be deployed to client-controlled infrastructure. Any development environment and the final deployment plan are defined in the scope.
We define how upstream errors are translated, which failures are safe to retry, what context the user needs, and what is recorded for operations. The evaluation suite includes representative dependency and partial-failure cases.
Tell us what the user should be able to accomplish, which systems hold the data, and which actions need permission or confirmation. We will map the smallest production MCP surface that can do the job.