Wardrik.MCPServers (wardrik_protocol v0.1.0-rc.1)

Operations on the MCP servers an org or person adds for their agents at runtime.

Wardrik.MCPServers.add(scope, owner: "acme", name: "docs", url: "https://docs.example.com/mcp", auth: %{none: %{}})
#=> {:ok, %Wardrik.MCPServerAdded{server: "docs", connected: true, authorization: nil}}

Summary

Functions

add(scope, input \\ [])

Add an MCP server for an owner's agents

list(scope, input \\ [])

List the MCP servers an owner added

remove(scope, server, input \\ [])

Remove an MCP server

Functions

add(scope, input \\ [])

@spec add(Wardrik.Scope.t(), term()) :: term() | :ok | {:error, Wardrik.Error.t()}

Add an MCP server for an owner's agents

An org's server serves its own agents and every agent of its people; a person's serves their agents alone. Its tools reach them from their next turn.

POST /v1/servers

list(scope, input \\ [])

@spec list(Wardrik.Scope.t(), term()) :: term() | :ok | {:error, Wardrik.Error.t()}

List the MCP servers an owner added

GET /v1/servers

remove(scope, server, input \\ [])

@spec remove(Wardrik.Scope.t(), String.t() | struct(), term()) ::
  term() | :ok | {:error, Wardrik.Error.t()}

Remove an MCP server

Its tools leave its agents from their next turn, and the sign-ins to it are forgotten.

DELETE /v1/servers/{server}