A Model Context Protocol (MCP) adapter that enables seamless integration with MCP-compatible AI models and tools. Provides standardised communication protocols for AI agents to interact with external systems and services. Essential for building sophisticated AI workflows and connecting with modern AI development ecosystems.
| Name: | mcp |
| Class: | covia.adapter.MCPAdapter |
This adapter provides 6 MCP tool(s) for AI agent integration:
| Tool Name | Description |
|---|---|
| mcp_server_remove | Removes a bridged MCP server (#80): deletes its catalog subtree and registry entry — nothing else. In-flight calls fail at the point of use. Scope 'venue' requires the mcp/manage ability. |
| mcp_tools_call | Runs a remote MCP tool via HTTP(s) |
| mcp_server_add | Mirrors an external MCP server into the catalog (#80): lists ALL the server's tools and materialises each as an ordinary operation. Scope 'user' (default) puts them in your o/mcp/<name>/ namespace; scope 'venue' (requires the mcp/manage ability) puts them at v/ops/mcp/<name>/ for everyone. To curate individual tools at paths of your choosing (including cross-server groups), use v/ops/mcp/add-tool instead. The server URL passes the same SSRF validation as the http adapter. Auth should be a secret reference (s/<name>, stored via v/ops/secret/set) — resolved at call time, never persisted raw. |
| mcp_tool_add | Curates ONE tool from an MCP server at a catalog path you choose (#80). The bridged op is self-contained (server, tool name, auth reference, schema all in the asset) — no registry entry, and groups are just catalog paths: place tools from different servers under a common prefix (e.g. o/research/) to arrange them as a set. Paths under your own o/ need nothing extra; v/ops/... requires the mcp/manage ability. Remove with covia:delete on the path — nothing resurrects it. To mirror ALL of a server's tools instead, use v/ops/mcp/add-server. Browse a server's tools first with v/ops/mcp/tools-list. |
| mcp_server_refresh | Refreshes bridged MCP tools against their servers' live tools/list (#80), in one of two modes. MIRROR (name): reconciles a registered server's whole subtree — new tools added, changed ones rewritten, vanished ones removed. CURATED (path): walks the bridged ops under a catalog path (one op or a whole group, may span servers), updates input/output schemas and annotations in place; name/description are yours and stay untouched; a tool the server no longer offers is reported in 'missing', never deleted. Provide exactly one of name or path. Venue-side targets require the mcp/manage ability. |
| mcp_tools_list | Lists available MCP tools from a remote server |