Discoverability and Reuse
Making APIs, MCP servers, capabilities, and related artifacts findable and reusable—reducing duplication and sprawl, and enabling teams to confidently build on what already exists.
Problem Statements (32)
| Problem Statement | Context | Impact | Naftiko Today | Naftiko Tomorrow | Type |
|---|---|---|---|---|---|
|
Need Semantic Search for API and MCP Discovery
Traditional filter-based catalog search doesn't match how developers think about their problems, leading to duplicate API development.
|
|||||
|
Need to Prevent MCP Sprawl
Multiple teams are independently building MCP integrations for the same third-party services without coordination or visibility.
|
|||||
|
Need Auto-Discovery of API Artifacts
Building an accurate catalog of APIs and services requires automated discovery rather than manual registration that developers resist.
|
|||||
|
Need to Define What Reuse Means
Pat has been asked to drive API reuse but the organization has never defined what reuse means.
|
|||||
|
Need Discoverability Not Just Governance
Pat realizes the organization has been focused on governance when the actual problem is that teams can't find what already exists.
|
|||||
|
Need Reuse Metrics That Connect to Business Outcomes
Laura needs reuse metrics that show business impact, not just activity counts.
|
|||||
|
Need to Discover and Govern Shadow API Gateways
Riley has an accurate central API inventory but cannot account for APIs on teams' own AWS API Gateways.
|
|||||
|
Need to Map APIs to Products and Business Capabilities
Riley has a clean API inventory but needs to understand how APIs map to products and business capabilities.
|
|||||
|
Need Artifact and Data Element Reuse
Riley realizes reuse isn't just about whole APIs—it's about reusing schemas, data elements, headers, and parameters.
|
|||||
|
Need to Quantify and Incentivize API Reuse
Riley was asked by leadership to answer how well they are reusing APIs and how they are incentivizing improvement.
|
|||||
|
Need Reuse Assessment in Architecture Review
Tina needs a mechanism during architecture review that provokes teams to assess existing capabilities before proposing new ones.
|
|||||
|
Need Central Catalog of 3rd-Party APIs
Noah needs a single catalog where internal teams can discover what 3rd-party APIs the organization uses.
|
|||||
|
Need Knowledge Graphs and Semantic Layers for API Context
Organizations need knowledge graphs and semantic layers to give AI agents structured, contextual understanding of API relationships, business logic, and entity models — not just flat catalogs.
|
|||||
|
Need APIs Discoverable by Agentic Browsers and AI-Native Workspaces
Agentic browsers and AI-native workspaces are becoming the primary interface for discovering and consuming services — APIs need to be optimized for Generative Engine Optimization (GEO), not just traditional developer portals.
|
|||||
|
Need an Internal MCP Server Registry as an Allow-List
Enterprises need an internal registry of approved MCP servers that surfaces inside the developer IDE, acting as an allow-list so developers discover only vetted servers.
|
|||||
|
Need Disease-Specific Information Models
Iris finds that EHRs are deliberately disease-agnostic, so the right information is rarely captured at the first patient encounter — sending patients on multi-month detours through the wrong specialists. She needs disease-specific information models that scaffold what to capture and when.
|
|||||
|
Need Multi-Stakeholder Patient-Centered Interoperability
Iris's project pulls in a vendor, a consultancy, a healthcare provider, and a university — each cares about a different slice of the same patient. She needs an interoperability fabric that lets every stakeholder see only what they should and contribute only what they own.
|
|||||
|
Need EHR-to-Open-Standards Mapping (OMOP, openEHR, FHIR)
Iris and peers across Sweden are starting to ask the same question — how do we map raw vendor EHR records into open standards (OMOP, openEHR, FHIR) without doing it by hand for every region. She needs a declarative, reusable mapping layer that survives EHR vendor changes.
|
|||||
|
Need Internal API Marketplace with Admin Model From Day One
Internal API marketplaces shipped without a defined roles, permissions, and admin-ownership model become unworkable — discovery surfaces with no governance underneath cost more to maintain than they save.
|
|||||
|
Need MCP Wrapping for Legacy SOAP/XML Systems
Enterprises need a way to expose legacy SOAP, XML, and other pre-REST backends as MCP server tools so agents can read and write to systems no team wants to evolve — without forcing a multi-year rewrite or rebuild of the underlying stack.
|
|||||
|
Need EDI-to-API Payload-Assist Pattern
Integration platforms bridging X12 EDI to modern APIs need a payload-assist pattern that surfaces the full per-trading-partner specificity without collapsing it under a thin normalized schema — otherwise the JSON-shaped API loses the lineage and validation that made the EDI document useful in the first place.
|
|||||
|
Need Trading-Partner Superset Schema with Per-Partner Validation
Integration platforms exposing data to consumers across thousands of trading-partner relationships need a superset schema for inbound retrieval (so callers see every property and per-partner nuance) paired with per-trading-partner schemas for outbound writes (carrying the required / conditional / optional flags translated from source-system syntax to JSON Schema validation rules).
|
|||||
|
Need Multi-Channel Integration Framework for EDI, API, and MCP
Order and document flow no longer travels a single channel — traditional EDI, API-over-EDI, standard API, social-commerce (TikTok / WhatsApp stream-driven order flow), agentic commerce, and now MCP all need to converge into the same backend, but most integration platforms force a separate stack per channel.
|
|||||
|
Need a Standards-Stack Onramp for Engineers Shipping a First Public API in the Agent Era
Engineers at closed-off enterprises shipping their first public API now have to ingest OpenAPI, Arazzo, JSON-LD, MCP, agent skills, async patterns, and agent-payment standards in weeks — with no sequenced onramp that says what to learn, when, and why.
|
|||||
|
Need API Referential with Auto-Published Portal and Changelog
Need an asset database of APIs that auto-publishes specs and breaking-change changelogs into the systems developers actually use — Confluence, intranet, internal portal — because most enterprises do not yet have a true internal developer portal.
|
|||||
|
Need Coherence Vector: Strategy-to-Work Traceability for API Programs
Need every API to carry first-class metadata linking it to the job-to-be-done, the team goal, and the group strategic objective it serves, so anyone working on it knows they are going in the right direction.
|
|||||
|
Need Business-Person Self-Service API Design Without Backend Build
Business product managers need to design and stand up the APIs they need without having to develop a backend, because most enterprise APIs are data APIs and the design work is about assembling existing data.
|
|||||
|
Need API Onboarding Flow Standardization Beyond Translation
API onboarding flows — sign-up, account creation, scopes, token issuance — are wildly inconsistent across providers, and the translation/gateway layer does not fix the hard middle: the onboarding-flow layer itself.
|
|||||
|
Need Agent-Writeable API Directory
API directories die when only humans can write to them; agents need to be first-class registrants so the directory's feedback loop stays alive at agent-web scale.
|
|||||
|
Need Dynamic Tool Discovery with Client Compatibility
MCP servers exposing dynamic tool discovery still run ahead of client support, leaving a cross-ecosystem compatibility gap that blocks scaling tool catalogs past a handful of agents.
|
|||||
|
Need Outcome-Centric Product Management Replacing Features
Product and product-marketing leaders are moving away from feature talk to outcome talk — top-line growth and bottom-line reduction — and the tooling that describes products still leads with features.
|
|||||
|
Need Event Destinations as the Agent Backbone, Not Just HTTP
At meaningful agentic scale, agents and humans should be guided to durable-queue event destinations — SQS, EventBridge, Pub/Sub, Kafka, RabbitMQ — not HTTP-only delivery, because the producer / consumer pie shifts when agents are producing events at machine pace.
|