Integrate Legation without rebuilding your product around an agent.

Your application can call a known MCP tool, delegate an objective to a customer-side agent, or invoke a native service. Agentic orchestration is a choice—not a requirement.

01 / Choose the simplest path

Start with what your application already knows.

MCP

Exact tool known

Invoke a known MCP tool through Legation. No operator-side agent is needed — the tool runs in-VPC and returns a governed projection.

A2A

Goal needs reasoning

Delegate an objective to the customer-side agent. It plans and uses the MCP tools locally, and returns a projection.

API

Traditional service call

Invoke an approved native service in-VPC. Same membrane, same projected return — no agents or MCP required.

Every pattern goes through the embassy — none is a wire to the workloads.The operator issues an intent; the embassy is the only actor that touches the MCP server or agent, in-VPC. Only a redacted projection crosses back. Legation is a governed membrane, not a pass-through.
02 / Known tool call

Your application makes a known tool call. Legation governs the round trip.

Vendor ApplicationLegation ClientEmbassyMCP Server (in-VPC)Projection

Optimal when your application already knows the exact tool and arguments. Legation supplies secure addressing, identity, transport, authorization context, and audit correlation. The tool executes next to the data inside the VPC; only a governed projection returns — never the raw records.

Conceptual known-tool-call invocation
const result = await legation.invoke({
  embassy: "acme-production",
  target: "records-service",
  operation: "evidence.search",
  input: { framework: "CMMC", control: "AC.L2-3.1.1" }
});

Illustrative interface. Align the final SDK shape with the shipping client contract.

03 / Agentic delegation

Your application delegates an objective. The agent reasons in-VPC.

Vendor App / AgentLegationA2A AgentMCP ServerProjection

Use this pattern when the operator describes an objective instead of a specific tool call. The agent performs customer-local reasoning and chooses which approved MCP tools are needed. Its raw work stays in-VPC; the vendor receives a governed projection of the outcome.

Conceptual task delegation
const task = await legation.delegate({
  embassy: "acme-production",
  agent: "review-agent",
  objective: "Review available evidence and identify control gaps."
});
Where the operator-side agent fitsA reference operator-side agent can create this delegation. A vendor can instead use its own agent, workflow engine, orchestration code, or application logic.
04 / Native application service

Agents and MCP are cargo types—not prerequisites.

A software vendor may need to run a proprietary service, data processor, compliance engine, security scanner, or customer-specific application inside the VPC. The same delivery and governance substrate can carry structured service operations.

Vendor WorkflowLegation SDK/APIApproved ServiceCustomer SystemsProjection

Even with no agent and no MCP in the path, the return is governed the same way: the service runs against customer systems in-VPC, and only a permitted projection crosses back.

05 / Customer-side roles

The agent reasons. The MCP server provides tools.

A2A agent

  • Receives delegated objectives
  • Plans customer-local work
  • Chooses approved tools
  • Coordinates multi-step execution
  • Returns a governed result

MCP server

  • Exposes named tools and resources
  • Touches customer-local data
  • Calls internal systems and APIs
  • Returns structured tool results
  • Remains unexposed to the public internet
06 / Integration contract

What the vendor application needs from Legation.

CapabilityWhy it matters
Embassy addressingSelect the correct customer, environment, and workload
Identity bindingProve which application or workload created the request
Request / reply correlationSupport synchronous, asynchronous, and long-running tasks
Timeout and cancellationGive the vendor predictable operational control
Streaming and progressSupport long-running agent and tool workflows
Audit contextConnect vendor actions to customer-side evidence
DiscoveryList authorized agents, tools, services, and capabilities