Large enterprises manage an average of 1,295 SaaS applications and over 14,000 internal APIs – a number compounded by an 807% year-over-year surge in AI-related APIs. The result is escalating cost from duplicate integrations, ungoverned security exposure, and brittle delivery pipelines where developers spend more time on archaeology than building. Naftiko Framework addresses this head-on by providing a declarative, spec-driven approach to turning that sprawl into a reusable, discoverable capability inventory.
What Is the Naftiko Framework
Naftiko Framework is an Apache 2.0-licensed, Java-based open-source project consisting of three core components:
Capability Spec – A declarative YAML specification, validated by JSON Schema and Spectral governance rules, that defines how each capability consumes, orchestrates, and exposes APIs. Everything is committed to Git and governed as code.
Engine – A Docker-based runtime that interprets the capability spec and runs it as a live service, progressively abstracting APIs from raw HTTP forwarding through structured API clients to functional MCP endpoints.
CLI – A command-line interface for local spec validation, Docker container lifecycle management, remote capability control, and Agent Skills installation.
Progressive Abstraction Architecture
The framework introduces a four-level progressive abstraction model for consumed APIs:
- Level 1: Forwarding HTTP client – Forward any HTTP call with shared endpoint behavior such as security.
- Level 2: Templatized HTTP client – Reuse predefined, templatized request collections imported from HAR, Postman, or similar formats.
- Level 3: Structured API client – Abstract HTTP calls into clean web API paths and operations, enabling API reusability across teams.
- Level 4: Functional MCP client – Abstract structured APIs into MCP tools, resources, and prompts, enabling context engineering for copilots and agents.
This architecture meets teams where they are, allowing incremental adoption without requiring a wholesale rearchitecture of existing integrations.
What Ships in Alpha 1
This first alpha delivers capabilities across three areas:
Right-Sized AI Context – Declarative applied capabilities that expose Agent Skills, plus MCP support for Resources and Prompts alongside existing Tools support. Capabilities shape response payloads into smaller, typed outputs aligned to tasks – reducing hallucination risk and improving agent accuracy.
API Reusability – Support for lookups within API call steps, consumer authentication and permissions for API and MCP servers, reusable source HTTP adapter declarations across capabilities, and declarative applied capabilities that compose multiple source capabilities.
Core Developer Experience – Published artifacts include Maven Central packages, Docker Hub images, Javadocs on javadoc.io, a Naftiko Skill based on the CLI, a Spectral-based ruleset for spec governance, a JSON structure for validation, a GitHub Action template based on Super Linter, and a comprehensive wiki with FAQ, getting started guide, and roadmap.
Who It Is For
Naftiko Framework is built for integration engineers, platform engineers, and architects at large enterprises who need to tame API sprawl while preparing their organizations for AI-driven workflows. The framework is designed for organizations with heavy investment in APIs, SaaS, and AI – where data is a strategic asset accessed via multiple protocols and where standardization and governance are operational imperatives.
Open-Source First
The Naftiko Framework is fully open source under the Apache 2.0 license. It is the foundation of an open-core model that includes a free Community Edition, a Standard Edition with SLA and collaboration features, and an Enterprise Edition with federation, continuous compliance, and domain-level governance. The framework itself will always remain open source, with the goal of becoming a community-driven standard for governed API-to-AI integration.
What Comes Next
- Alpha 2 (May 2026) – Agent orchestration via A2A and Webhook server adapters, MCP authentication, enhanced orchestration with conditional, for-each, and parallel steps, a Control API accessible via CLI, and a Docker Desktop Extension.
- Beta (June 2026) – Stable specification, resilience patterns (circuit breaker, retry, rate limiter, bulkhead), gRPC/tRPC server adapters, and MCP server-side code mode.
- General Availability (September 2026) – Production-ready v1.0 with full test coverage, stable spec, and JSON Schema published to JSON Schema Store.
Get Started
- GitHub: github.com/naftiko/framework
- Wiki & Docs: github.com/naftiko/framework/wiki
- Docker Hub: Available on Docker Hub
- Maven Central: Available on Maven Central
About Naftiko
Naftiko reinvents API integration for the AI era. Its governed, spec-driven platform transforms the fragmented landscape of SaaS APIs, microservices, and AI tools into a unified capability fleet – discoverable by humans and machines, governed by policy, and observable by design. Founded on the values of openness, sustainability, and responsible use, Naftiko is building the connective tissue between enterprise API investments and the AI-powered future. Naftiko operates from Paris and New York City.
| Media Contact: press@naftiko.io | naftiko.io |
