Surfaces
A surface is any API, MCP server, or tool layer you connect to Invoked. Add surfaces from the Exchange or bring your own REST/MCP endpoint, then give agents native access to them.
A surface is anything you connect Invoked to so your agents can use it — an MCP (Model Context Protocol) server, a REST API, or a hosted tool layer. Each surface becomes a first-class workspace you can chat against, orchestrate agents over, and measure.
Surfaces are the unit of integration in Invoked. Instead of wiring an API into bespoke code, you add it once as a surface and every part of the app — Chat, the Agent Orchestrator, Harnesses, Evals — can use its tools.
What can be a surface?
| Type | Example | How you add it |
|---|---|---|
| MCP server | A stdio or HTTP Model Context Protocol server | From the Exchange, or paste its command / URL |
| REST API | Any HTTP+JSON API | Import an OpenAPI/GraphQL spec or a cURL command |
| Hosted tool layer | A vendor's agent/tool endpoint | From the Exchange catalog |
Adding a surface
The fastest way is the Exchange — search the curated catalog, pick a surface, and add it in one step. Surfaces that need credentials prompt you for them at add time; secrets go straight into your operating system keychain and never touch disk in plaintext.
To bring your own:
- Open the surface switcher (top of the sidebar) and choose Add surface.
- Choose MCP (paste the server command or URL) or REST (import a spec or cURL).
- Fill in any required configuration. Required secrets are stored in the keychain.
Only surfaces added from the Exchange carry a catalog identity (a registryName). That identity is what lets a surface contribute anonymous, opt-in performance metrics back to the public Exchange pages — ad-hoc REST/MCP surfaces never do.
Surfaces and your workspace
Each surface is workspace-scoped: its tools, runs, skills, and stats live alongside it. Switching surfaces in the sidebar switches the entire working context. This is what makes Invoked's knowledge compound — the more you run a surface, the richer its local history, skills, and performance data become.