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.
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.
Invoke a known MCP tool through Legation. No operator-side agent is needed — the tool runs in-VPC and returns a governed projection.
Delegate an objective to the customer-side agent. It plans and uses the MCP tools locally, and returns a projection.
Invoke an approved native service in-VPC. Same membrane, same projected return — no agents or MCP required.
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.
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.
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.
const task = await legation.delegate({ embassy: "acme-production", agent: "review-agent", objective: "Review available evidence and identify control gaps." });
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.
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.
| Capability | Why it matters |
|---|---|
| Embassy addressing | Select the correct customer, environment, and workload |
| Identity binding | Prove which application or workload created the request |
| Request / reply correlation | Support synchronous, asynchronous, and long-running tasks |
| Timeout and cancellation | Give the vendor predictable operational control |
| Streaming and progress | Support long-running agent and tool workflows |
| Audit context | Connect vendor actions to customer-side evidence |
| Discovery | List authorized agents, tools, services, and capabilities |