autessa.mcp
MCP server configuration.
autessa.mcp.servers.allREAD
autessa.mcp.servers.all()List every remote MCP server registered in the current company.
Returns all server registrations scoped to your current company. Not paginated. Auth secrets are never included — each server reports only a hasAuthConfig boolean.
Request fields
No fields.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
servers- Type
- McpServerDto[]
- Description
autessa.mcp.servers.createMUTATE
autessa.mcp.servers.create({ name, serverUrl, description, authType, authConfig })Register a remote MCP server by name and serverUrl, with optional auth (authType NONE | API_KEY | BEARER_TOKEN | BASIC_AUTH | CUSTOM_HEADERS and authConfig as a JSON string).
name and serverUrl are required (blank values are rejected). authType defaults to NONE. authConfig is a JSON string whose keys depend on authType (for example {"apiKey":...,"headerName":...} or {"bearerToken":...}); it is encrypted at rest and can never be read back — responses only expose a hasAuthConfig boolean. No connectivity check happens at create time — call mcp.servers.testConnection afterwards to verify the server is reachable.
Request fields
- Name
name- Type
- string
- Description
- Name
serverUrl- Type
- string
- Description
- Name
description- Type
- string
- Description
- Name
authType- Type
- "NONE" | "API_KEY" | "BEARER_TOKEN" | "BASIC_AUTH" | "CUSTOM_HEADERS"
- Description
- Name
authConfig- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
server- Type
- McpServerDto
- Description
autessa.mcp.servers.deleteMUTATE
autessa.mcp.servers.delete({ serverId })Permanently delete an MCP server registration (hard delete).
Irreversible hard delete of the registration and its stored (encrypted) auth config. The server must exist in your current company or the call fails with an error. Tools already promoted from this server via tools.createFromMcp are not removed by this call.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
autessa.mcp.servers.getREAD
autessa.mcp.servers.get({ serverId })Fetch one MCP server registration by id; authConfig is never returned, only a hasAuthConfig boolean.
Returns the registration if it exists in your current company; otherwise the call fails with a not-found/access-denied error. No live network call is made — this reads stored configuration only.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
server- Type
- McpServerDto
- Description
autessa.mcp.servers.listPromptsREAD
autessa.mcp.servers.listPrompts({ serverId })List the prompts advertised by the remote MCP server (live synchronous network call — can be slow or fail if the server is unreachable).
Introspects a registered server over the network with its stored auth and returns its advertised prompts (name, description, argument definitions). The server must exist in your company. If the server is unreachable or errors, the call returns an errors entry rather than prompts.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
prompts- Type
- McpPrompt[]
- Description
autessa.mcp.servers.listResourcesREAD
autessa.mcp.servers.listResources({ serverId })List the resources advertised by the remote MCP server (live synchronous network call — can be slow or fail if the server is unreachable).
Introspects a registered server over the network with its stored auth and returns its advertised resources (uri, name, description, mimeType). The server must exist in your company. If the server is unreachable or errors, the call returns an errors entry rather than resources.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
resources- Type
- McpResource[]
- Description
autessa.mcp.servers.listToolsREAD
autessa.mcp.servers.listTools({ serverId })List the tool definitions advertised by the remote MCP server (live synchronous network call — can be slow or fail if the server is unreachable); use tools.createFromMcp to promote one into an Autessa Tool.
Introspects a registered server over the network with its stored auth and returns its advertised tools (name, description, JSON input schema). The server must exist in your company. If the server is unreachable or errors, the call returns an errors entry rather than tools. Promote a returned tool into a first-class Autessa Tool with tools.createFromMcp.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
tools- Type
- McpTool[]
- Description
autessa.mcp.servers.testConnectionMUTATE
autessa.mcp.servers.testConnection({ serverId })Connect to the remote MCP server with its stored credentials and report {connected, message, toolCount}; failures come back as connected false rather than an error.
Makes a live synchronous network call using the server's stored auth to establish a session and count its tools. A connectivity or auth failure is reported as connected=false with a message and toolCount=0 — it is not surfaced as an errors entry. An errors entry appears only when the server id is missing or not found in your company. No data is mutated; classified MUTATE/EXECUTE because it triggers an outbound side-effecting call.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
connected- Type
- boolean
- Description
- Name
message- Type
- string
- Description
- Name
toolCount- Type
- number
- Description
autessa.mcp.servers.updateMUTATE
autessa.mcp.servers.update({ serverId, name, serverUrl, description, authType, authConfig })Patch an MCP server's name, serverUrl, description, or auth settings; only the fields you send are changed.
Sparse update: any field left null is left untouched — this is NOT a whole-entity replace, so you need not read the server first. serverId is required and the server must exist in your current company. Sending authConfig re-encrypts and replaces the stored credentials; omit it to keep the existing auth config. Connectivity is not re-validated — verify with mcp.servers.testConnection after changing the URL or auth.
Request fields
- Name
serverId- Type
- string (opaque id)
- Description
- References mcp server by opaque id.
- Name
name- Type
- string
- Description
- Name
serverUrl- Type
- string
- Description
- Name
description- Type
- string
- Description
- Name
authType- Type
- "NONE" | "API_KEY" | "BEARER_TOKEN" | "BASIC_AUTH" | "CUSTOM_HEADERS"
- Description
- Name
authConfig- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
server- Type
- McpServerDto
- Description