Input methods
Server Foundry supports multiple ways to get started, so you can build an MCP server regardless of how your API is documented:OpenAPI specification
OpenAPI specification
Upload an OpenAPI spec file (JSON or YAML). The Designer Agent parses the spec, extracts all endpoints and schemas, and guides you through selecting and optimizing the tools.
Postman Collection
Postman Collection
Upload a Postman Collection file. The Designer Agent converts the collection’s requests into MCP tool definitions, preserving headers, parameters, and request bodies.
API documentation URL
API documentation URL
Provide the URL of an API’s documentation site. Caylex crawls the documentation pages and extracts API endpoints automatically. You review and approve all discovered pages before the Designer Agent proceeds with generation.
Browser workflow recording (coming soon)
Browser workflow recording (coming soon)
Use Caylex’s browser extension to record your workflows on any web app. Caylex extracts the underlying network requests and builds an MCP server from the derived API calls — no spec or documentation required.
When to use Server Foundry
Server Foundry is for when you have an API that is not available in the Caylex Catalog and you want to make it accessible to your AI agents through MCP. Common use cases:- Internal APIs — expose your company’s internal services to AI agents
- Third-party APIs — connect APIs from vendors that do not yet have MCP servers
- Custom integrations — build tailored MCP servers with only the endpoints your agents need
- Undocumented APIs — use the browser extension (coming soon) to capture API calls from any web app, even those without formal documentation
What you get
When you complete the Server Foundry workflow, Caylex generates:- A production-ready MCP server deployed and managed by Caylex
- Optimized tool definitions with names and descriptions tuned for AI agent consumption
- Authentication handling built in (header-based or OAuth)
- A server that appears in your Servers list, ready to be connected to any project
How it works
Server Foundry uses the MCP Designer Agent — an AI assistant that guides you through a multi-phase workflow:- Provide API source — upload a spec, provide a documentation URL, or import a Postman collection
- Use Case Discovery — the agent analyzes your API and identifies use cases
- Template Generation — the agent creates workflow templates grouping related endpoints
- Tool Selection — you choose which tools to include
- Toolset Validation — Caylex validates that all selected tools can be sequenced into usable workflows by mapping input/output dependencies across endpoints (e.g., ensuring an endpoint that requires an ID has a corresponding endpoint to discover that ID)
- Tool Optimization — the agent optimizes tool names and descriptions for AI agents
- Preview & Generate — review the final configuration and deploy
Step-by-step guide
Walk through the complete Server Foundry workflow from upload to deployment.
The workspace
Server Foundry uses a split-screen workspace:- Left panel — a chat interface where you converse with the Designer Agent
- Right panel — a dynamic workspace that shows different views for each phase (use cases, template selector, tool optimizer, server preview)
- Top bar — a progress navigator showing your current phase and completion status