tenant-aware · default-denyMCP 2025-11-25 · OpenAPI · SOAP · OData · OIDCBuilt for enterprise AI
v1.1.6Tenant-awareMCP 2025-11-25

Turn enterprise
REST, SOAP and OData APIs
into governed
AI tools.

AI API Mapper sits between the business APIs you already run and the agents that want to call them — adding contract onboarding, mapping, publication, identity, governance, and auditable execution across REST, SOAP, and OData/Microsoft Graph integrations. Ship it to agents with client SDKs in .NET, TypeScript, Python, and Java.

  runtime · trace 7f3c…91b2tools/call
01AI client MCP requestJWT
02Runtime authorizes against policydefault-deny
03Resolve credentials · transform inputkey vault
04Invoke downstream REST or SOAP endpointallow-list
05Transform output · record audittrace
The Gap

AI clients can't safely call the APIs
you already built.

Downstream APIs were designed for web, mobile, or system-to-system integrations. AI tools need clear names, typed inputs, predictable outputs, and a controlled execution boundary — and someone needs to know who called what, under which tenant, with which credentials.

10+
Downstream auth strategies
3
Schema discovery modes
4
Executable hosts
2025-11-25
MCP protocol compliant
Architecture

Four hosts. One governed product.

The platform is a modular monolith with separate executable hosts for administration, runtime execution, background processing, and edge routing — backed by a shared persistence model.

/ 01

Portal

Admins · Operators

REST admin API plus a web app for human administrators. Onboarding, mapping authoring, toolset and client-app management, identity, governance dashboards, audit review.

  • API onboarding
  • Mapping lifecycle
  • MCP toolsets
  • Governance dashboards
/ 02

Runtime

AI clients · Copilots

The AI-facing execution surface. Presents a per-tenant tool catalog, authorizes callers, resolves credentials, transforms requests and responses, records audits.

  • MCP JSON-RPC 2.0
  • REST + SOAP execution
  • Configuration snapshots
  • Call-trace by correlation
/ 03

Jobs Worker

Async workloads

Background processing for semantic enrichment, governance audit, and scheduled retention. Message-driven execution, retry handling, and scheduled maintenance are kept outside the request path.

  • Semantic enrichment
  • Retention windows
  • Quartz scheduler
  • Retry behavior
/ 04

Gateway

Network edge

Reverse-proxy entry point in front of all internal hosts. Enforces per-route authentication requirements and lightweight JWT structural validation before proxying. Strips untrusted forwarding and hop-by-hop headers, applies per-identity edge rate limiting by traffic category, and centralizes browser security, request correlation, and ingress observability.

  • Reverse proxy
  • JWT precheck
  • Header hardening
  • Edge rate limiting
  • Health & metrics
Capabilities

From onboarding to audited execution —
end to end.

Six functional areas, owned by one platform, configured by humans in the Portal and enforced by the Runtime on every call.

C-01
Onboard from OpenAPI, WSDL, or OData
Import API definitions from a URL or raw document — OpenAPI, SOAP/WSDL, or OData v4 (CSDL), including Microsoft Graph. CSDL is parsed into a canonical semantic model before translation, so entity sets, navigation, actions/functions, and capability restrictions (InsertRestrictions/UpdateRestrictions/DeleteRestrictions) survive rather than being flattened. Every protocol shares the same preview/curation workflow — allow/deny lists, tag/path filters, and a mandatory explicit-selection step for oversized contracts.
OpenAPI importSOAP/WSDL importOData/CSDL importMicrosoft Graph dialectPreview & curateSchema browse
C-02
Author the mapping lifecycle
Mappings carry the contract boundary: ExposedFieldName for AI callers, SourceFieldName for the downstream request. Draft, version, approve, publish, deprecate, revert, restore. When the source API belongs to a versioned family, new mapping drafts can be seeded from a specific API revision — preserving endpoint IDs where operations match so toolset selections survive an API update. Each endpoint can also carry behavioral annotation hints (read-only, destructive, idempotent, open-world) for MCP clients.
Exposed ↔ Source fieldsVersioningAPI version targetingAnnotation hintsREST + SOAPApprovalPublishRestore
C-03
Enrich with AI assistance
Chunked LLM pipeline generates names, descriptions, field suggestions, and endpoint behavioral annotation hints as a proposal alongside the draft — never overwriting it. Accept per field, per endpoint, or whole. Cancel mid-run. Every chunk is traced with prompt, raw output, and token counts. Attach up to 5 reference documents (.txt, .md, .pdf) to give the LLM extra context beyond the imported contract — scanned for prompt injection before processing, with extracted text and content hashes recorded on the run. Configure OpenAI-compatible or Azure OpenAI connections with named model profiles. Set per-tenant default models, or pick a specific model profile for each individual enrichment run.
Proposal reviewGranular acceptAnnotation hint inferenceReference attachmentsCancellable runsPer-chunk traceabilityPer-tenant model defaultsPer-run model override
C-04
Publish to MCP toolsets
Bundle endpoints into toolsets, assign to tenant-scoped client apps, manage API keys. Pick the schema discovery mode (Full · Data-Structure-Only · Lazy) per toolset, override per endpoint. Compose system prompts across three layers — toolset, client, and assignment (append or override).
MCP toolsetsSchema discovery modesPrompt compositionClient appsAPI keys
C-05
Bind downstream credentials
Target systems, target authentication profiles, tool endpoint authentication bindings, credential workflow definitions, outbound host allow-lists, managed secret storage, and secret store connections all come together in one security surface.
Passthrough bearerAPI keyBasic authSOAP UsernameTokenSOAP headersWorkflows
C-06
Govern at the runtime edge
Default-deny tool authorization. Per-tool policies on issuer, client ID, roles, scopes, groups, custom claims. Configurable audit filters. Opt-in sanitized request/response capture and per-step call trace timing across REST and SOAP executions. Every governance event can be fanned out durably to external compliance sinks — REST endpoints, syslog receivers, SQL Server tables, or PostgreSQL tables — with retry, worker leasing, and per-target health monitoring.
Default-denyPer-tool policySanitized captureREST + SOAP tracesAudit filtersExternal audit fan-out
Under the hood

The four contracts
that make this work.

Most of the platform's value lives in four small but specific contracts. They are the ones your engineers will ask about first.

/ Field contract

Exposed Source

Mappings split what an AI caller sees from what the downstream service receives. ExposedFieldName is the MCP-visible business vocabulary; SourceFieldName is the downstream path the runtime translates to on the way out and back. Structural markers (nested objects, [*] array positions) survive round-trip.

{
  "ExposedFieldName": "customerEmail",
  "SourceFieldName":  "data.party[*].contacts.email"
}
/ MCP schema modes

Three discovery modes

Per toolset (overridable per endpoint): Full sends the complete schema with descriptions; Data-Structure-Only keeps the shape but drops descriptions to cut tokens; Lazy returns only a discovery placeholder. When Lazy or DSO is in play, the runtime injects a discover_tool_schema meta-tool that returns the authoritative inputSchema, outputSchema, version and hash.

tools/list  →  inputSchema: {
  "_schema_discovery": "use discover_tool_schema"
}
/ Prompt composition

Three layers, one prompt

The effective MCP system prompt is composed from the toolset default, the client application prompt (when the assignment opts in), and an optional assignment-specific prompt set to either Append or Override. The same toolset can therefore present different effective prompts to different client applications inside the same tenant.

effective_prompt =
  toolset.default
  + (client.prompt if opt_in)
  + (assignment.custom : append | override)
/ Sanitized capture

Audit you can show auditors

Request/response logging is opt-in at toolset level with per-endpoint overrides. Captured MCP and downstream HTTP payloads are sanitized: Authorization, token, api_key, secret, password, cookie names are redacted in headers, JSON properties, and query strings. Content past 512KB (configurable) is truncated with a marker.

Authorization: Bearer [redacted]
{ "api_key": "[redacted]", ... }
?secret=[redacted]&limit=20
Client SDKs

Three method calls.
No MCP plumbing.

Native client libraries in .NET, TypeScript, Python, and Java expose the same conceptual interface — get the system prompt, get the tools, invoke a tool — with session management, credential injection, and MCP pagination handled internally. Orchestrator adapters convert the tool list into the native format expected by Microsoft.Extensions.AI, Semantic Kernel, Azure AI Foundry Agents, OpenAI, LangChain, LangGraph, and Spring AI.

/ 01

.NET

dotnet add package

CodedProjects.AI.ApiMapper.Client

  • Get system prompt
  • Get tools (paginated)
  • Invoke tool
/ 02

TypeScript

npm install

@codedprojects/api-mapper-client

  • Get system prompt
  • Get tools (paginated)
  • Invoke tool
/ 03

Python

pip install

api-mapper-client

  • Get system prompt
  • Get tools (paginated)
  • Invoke tool
/ 04

Java

Maven / Gradle

com.codedprojects:api-mapper-client

  • Get system prompt
  • Get tools (paginated)
  • Invoke tool
Technical evaluation

What technical buyers usually
need to verify first.

This is not a brochure-first product. The fastest evaluation path is to inspect the architecture, the runtime contract model, and the governance surface in that order.

/ Architecture proof

Review the host model and execution boundaries

Start from the platform and runtime specifications to verify how Portal, Runtime, Gateway, and Jobs Worker divide responsibilities, trust boundaries, and operational ownership.

Open architecture docs
/ Contract proof

Inspect the mapping and MCP contract model

Validate how exposed fields, source fields, schema discovery, prompt composition, and tool publication work before you invest time in a pilot.

Open Runtime spec
/ Governance proof

Check the audit, policy, and traceability model

Confirm how default-deny authorization, sanitized logging, claim checks, and correlation-level trace data behave in a governed production environment.

Open governance docs
/ Deployment fit

Understand the hosting and licensing model

Review how the platform is deployed inside customer infrastructure, how Runtime nodes are counted, and how the commercial model scales with real production footprints.

Open pricing
Inside the Platform

A closer look at the
platform in use.

A selection of platform screens covering onboarding, mapping, governance, and runtime traceability. Useful for technical evaluators who want to inspect how the product behaves in practice.

API onboarding from real imported definitions
/ Portal

API onboarding from real imported definitions

Shows imported API records, operation counts, schema counts, and the actual onboarding workspace used to start mapping work from OpenAPI and SOAP/WSDL contracts.

Mapping editor with versioned field transformation
/ Portal

Mapping editor with versioned field transformation

Proves that mappings are editable, versioned, and built around exposed versus source field contracts inside the real product UI.

Toolset assignment and client application exposure
/ Portal

Toolset assignment and client application exposure

Shows how published mappings become tenant-scoped toolsets with client assignment, MCP URL exposure, and per-toolset behavior.

Monitoring dashboard with live operational filtering
/ Governance

Monitoring dashboard with live operational filtering

Confirms that audit exploration, event filtering, and monitoring are first-class product surfaces rather than external tooling.

Step-by-step call flow with timing breakdown
/ Traceability

Step-by-step call flow with timing breakdown

Shows governed execution stages, timing visibility, and correlation-driven traceability across the full runtime path.

Policy model with issuer, roles, scopes, and groups
/ Security

Policy model with issuer, roles, scopes, and groups

Proves that tool access control is configured as an explicit policy surface instead of being hidden inside custom code.

Main Functional Flow

Eight steps. One contract.

From OpenAPI or WSDL on disk to a governed, tenant-scoped tool answered by your downstream service — with every hop visible to your operators.

01
Onboard

An administrator imports an OpenAPI or SOAP/WSDL document into the Portal.

02
Map

The platform creates a mapping proposal turning selected operations into business-friendly tool definitions.

03
Review

Administrators review, edit, approve, version, and publish the mapping.

04
Group

Published mappings are grouped into a toolset and assigned to one or more client applications.

05
Secure

Configure downstream connectivity, authentication strategies, secret sources, and runtime access policies.

06
List

An AI client calls the Runtime to list available tools for a tenant and client application.

07
Invoke

Runtime authorizes the caller, resolves credentials, transforms the request, and calls the downstream REST or SOAP API.

08
Audit

Background jobs handle asynchronous work; every call lands as audit + call-trace data, fanned out durably to external compliance targets (REST, syslog, SQL Server, PostgreSQL).

Integrations

Speaks the enterprise stack
you already standardized on.

First-class support for Entra ID, Keycloak, and Azure Key Vault. Open standards for trust, transport, and tool exposure. Designed to fit into enterprise identity, messaging, and deployment environments.

Microsoft Entra ID
/ identity · Portal SSO · trust
Keycloak
/ identity · Portal SSO · trust
Azure Key Vault
/ secrets · Managed secrets
OpenAI / compatible
/ ai · LLM enrichment
Azure OpenAI
/ ai · LLM enrichment
OpenAPI
/ ingest · Contract import
SOAP / WSDL
/ ingest · Contract import
OData v4 / CSDL
/ ingest · Contract import
Microsoft Graph
/ ingest · OData dialect
MCP JSON-RPC 2.0
/ runtime · Tools / resources
OIDC + JWT
/ identity · Runtime trust
MassTransit
/ jobs · Background bus
RabbitMQ
/ jobs · Broker transport
Quartz
/ jobs · Scheduled work
SignalR
/ portal · Portal real-time
SQL Server
/ data · Platform database
PostgreSQL
/ data · Platform database
HTTP downstream
/ runtime · Outbound execution
SOAP downstream
/ runtime · Envelope execution
Reverse proxy
/ edge · Gateway routing
.NET / TypeScript / Python / Java SDKs
/ sdk · Client integration
Semantic Kernel · LangChain · LangGraph
/ sdk · Orchestrator adapters
Governance

Designed for the people who have to answer for it.

Three layers of governance — runtime access, execution, and security — so AI tool exposure stays inside your existing controls.

Runtime access

Default-deny authorization

  • Allowed token issuer
  • Allowed client IDs
  • Roles, scopes, groups
  • Custom claim requirements
  • Tenant-aware evaluation
  • Device Authorization Grant (RFC 8628) for agents & CLIs
  • Browser OAuth Authorization Code + PKCE via Portal login
Execution

Audited, traceable calls

  • Audit records for runtime activity
  • External fan-out to REST, syslog, SQL Server, PostgreSQL
  • End-to-end trace by correlation ID
  • Request / response visibility
  • Enrichment log monitoring
  • Validation outcome capture
Security

Hardening across the surface

  • Outbound host allow-lists
  • Gateway edge JWT precheck + rate limiting
  • Trusted IdP administration
  • Managed secret usage
  • Retention policies
  • Immediate session revocation, everywhere
  • Auto-revoke on refresh-token replay
Get started

Ready to expose APIs
to agents safely?

We'll walk through your environment, your downstream auth shapes, your expected Runtime footprint, and what a realistic first rollout would look like.

Request a technical walkthrough Read the docs