List an MCP server's tools
Changed onConnects to a remote MCP server over streamable HTTP, negotiates the protocol version (stateless server/discover first, falling back to the initialize handshake for session-based servers), and returns the server's tools/list result. The request is not stored; use it to preview which tools a server exposes before referencing it from an agent config. Authentication mirrors the agent config mcp_servers.<key>.auth shape and resolves secrets available to the project. When the server does not speak MCP, the API responds 422 without an auth hint. When the server or its authorization server does not respond or fails, including a malformed MCP response or a JSON-RPC internal error from the server, the API responds 424; retrying may succeed once the server recovers. When the authorization server rejects the configured OAuth secret, the API responds 422 with an oauth hint so the caller can log in again. When Omnara times out reading or storing discovery state, the API responds 503. When the server rejects the connection with HTTP 401 or 403, the API probes the server's authorization requirements and responds 422 with an auth hint — oauth when the server advertises an OAuth authorization server, bearer when it expects a token but advertises no OAuth metadata. If that probe fails for a non-transient reason, the 422 carries no auth hint.
Request
- Base URL: https://api.omnara.com/v1
- URL: https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/mcp-servers/tools
- Auth: one of:
- HTTP bearer
- API key in cookie __Host-omnara_session and API key in header X-Omnara-Csrf
Request body
Response
Tools advertised by the MCP server.
Changes
- breaking
the response property
became optional for the status - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the non-success response with the status
- info
removed the non-success response with the status
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
removed the
authentication_unavailableenum value from theresponse property for the response status - info
removed the
authentication_unavailableenum value from theresponse property for the response status - info
removed the
authentication_unavailableenum value from theresponse property for the response status - info
removed the
authentication_unavailableenum value from theresponse property for the response status - info
removed the
authentication_unavailableenum value from theresponse property for the response status - info
removed the
authentication_unavailableenum value from theresponse property for the response status - info
removed the
conflictenum value from theresponse property for the response status - info
removed the
conflictenum value from theresponse property for the response status - info
removed the
conflictenum value from theresponse property for the response status - info
removed the
conflictenum value from theresponse property for the response status - info
removed the
conflictenum value from theresponse property for the response status - info
removed the
conflictenum value from theresponse property for the response status - info
removed the
csrf_check_failedenum value from theresponse property for the response status - info
removed the
csrf_check_failedenum value from theresponse property for the response status - info
removed the
csrf_check_failedenum value from theresponse property for the response status - info
removed the
csrf_check_failedenum value from theresponse property for the response status - info
removed the
csrf_check_failedenum value from theresponse property for the response status - info
removed the
csrf_check_failedenum value from theresponse property for the response status - info
removed the
daemon_runtime_unregisteredenum value from theresponse property for the response status - info
removed the
daemon_runtime_unregisteredenum value from theresponse property for the response status - info
removed the
daemon_runtime_unregisteredenum value from theresponse property for the response status - info
removed the
daemon_runtime_unregisteredenum value from theresponse property for the response status - info
removed the
daemon_runtime_unregisteredenum value from theresponse property for the response status - info
removed the
daemon_runtime_unregisteredenum value from theresponse property for the response status - info
removed the
forbiddenenum value from theresponse property for the response status - info
removed the
forbiddenenum value from theresponse property for the response status - info
removed the
forbiddenenum value from theresponse property for the response status - info
removed the
forbiddenenum value from theresponse property for the response status - info
removed the
forbiddenenum value from theresponse property for the response status - info
removed the
forbiddenenum value from theresponse property for the response status - info
removed the
goneenum value from theresponse property for the response status - info
removed the
goneenum value from theresponse property for the response status - info
removed the
goneenum value from theresponse property for the response status - info
removed the
goneenum value from theresponse property for the response status - info
removed the
goneenum value from theresponse property for the response status - info
removed the
goneenum value from theresponse property for the response status - info
removed the
idempotency_key_conflictenum value from theresponse property for the response status - info
removed the
idempotency_key_conflictenum value from theresponse property for the response status - info
removed the
idempotency_key_conflictenum value from theresponse property for the response status - info
removed the
idempotency_key_conflictenum value from theresponse property for the response status - info
removed the
idempotency_key_conflictenum value from theresponse property for the response status - info
removed the
idempotency_key_conflictenum value from theresponse property for the response status - info
removed the
internal_errorenum value from theresponse property for the response status - info
removed the
internal_errorenum value from theresponse property for the response status - info
removed the
internal_errorenum value from theresponse property for the response status - info
removed the
internal_errorenum value from theresponse property for the response status - info
removed the
internal_errorenum value from theresponse property for the response status - info
removed the
internal_errorenum value from theresponse property for the response status - info
removed the
invalid_requestenum value from theresponse property for the response status - info
removed the
invalid_requestenum value from theresponse property for the response status - info
removed the
invalid_requestenum value from theresponse property for the response status - info
removed the
invalid_requestenum value from theresponse property for the response status - info
removed the
invalid_requestenum value from theresponse property for the response status - info
removed the
invalid_requestenum value from theresponse property for the response status - info
removed the
managed_work_admission_deniedenum value from theresponse property for the response status - info
removed the
managed_work_admission_deniedenum value from theresponse property for the response status - info
removed the
managed_work_admission_deniedenum value from theresponse property for the response status - info
removed the
managed_work_admission_deniedenum value from theresponse property for the response status - info
removed the
managed_work_admission_deniedenum value from theresponse property for the response status - info
removed the
not_foundenum value from theresponse property for the response status - info
removed the
not_foundenum value from theresponse property for the response status - info
removed the
not_foundenum value from theresponse property for the response status - info
removed the
not_foundenum value from theresponse property for the response status - info
removed the
not_foundenum value from theresponse property for the response status - info
removed the
not_foundenum value from theresponse property for the response status - info
removed the
not_wake_capableenum value from theresponse property for the response status - info
removed the
not_wake_capableenum value from theresponse property for the response status - info
removed the
not_wake_capableenum value from theresponse property for the response status - info
removed the
not_wake_capableenum value from theresponse property for the response status - info
removed the
not_wake_capableenum value from theresponse property for the response status - info
removed the
not_wake_capableenum value from theresponse property for the response status - info
removed the
pending_workenum value from theresponse property for the response status - info
removed the
pending_workenum value from theresponse property for the response status - info
removed the
pending_workenum value from theresponse property for the response status - info
removed the
pending_workenum value from theresponse property for the response status - info
removed the
pending_workenum value from theresponse property for the response status - info
removed the
pending_workenum value from theresponse property for the response status - info
removed the
rate_limitedenum value from theresponse property for the response status - info
removed the
rate_limitedenum value from theresponse property for the response status - info
removed the
rate_limitedenum value from theresponse property for the response status - info
removed the
rate_limitedenum value from theresponse property for the response status - info
removed the
rate_limitedenum value from theresponse property for the response status - info
removed the
rate_limitedenum value from theresponse property for the response status - info
removed the
request_too_largeenum value from theresponse property for the response status - info
removed the
request_too_largeenum value from theresponse property for the response status - info
removed the
request_too_largeenum value from theresponse property for the response status - info
removed the
request_too_largeenum value from theresponse property for the response status - info
removed the
request_too_largeenum value from theresponse property for the response status - info
removed the
request_too_largeenum value from theresponse property for the response status - info
removed the
service_unavailableenum value from theresponse property for the response status - info
removed the
service_unavailableenum value from theresponse property for the response status - info
removed the
service_unavailableenum value from theresponse property for the response status - info
removed the
service_unavailableenum value from theresponse property for the response status - info
removed the
service_unavailableenum value from theresponse property for the response status - info
removed the
service_unavailableenum value from theresponse property for the response status - info
removed the
state_transition_conflictenum value from theresponse property for the response status - info
removed the
state_transition_conflictenum value from theresponse property for the response status - info
removed the
state_transition_conflictenum value from theresponse property for the response status - info
removed the
state_transition_conflictenum value from theresponse property for the response status - info
removed the
state_transition_conflictenum value from theresponse property for the response status - info
removed the
state_transition_conflictenum value from theresponse property for the response status - info
removed the
unauthorizedenum value from theresponse property for the response status - info
removed the
unauthorizedenum value from theresponse property for the response status - info
removed the
unauthorizedenum value from theresponse property for the response status - info
removed the
unauthorizedenum value from theresponse property for the response status - info
removed the
unauthorizedenum value from theresponse property for the response status - info
removed the
unauthorizedenum value from theresponse property for the response status - info
removed the
unprocessableenum value from theresponse property for the response status - info
removed the
unprocessableenum value from theresponse property for the response status - info
removed the
unprocessableenum value from theresponse property for the response status - info
removed the
unprocessableenum value from theresponse property for the response status - info
removed the
unprocessableenum value from theresponse property for the response status - info
removed the
unprocessableenum value from theresponse property for the response status - info
removed the
unsupported_media_typeenum value from theresponse property for the response status - info
removed the
unsupported_media_typeenum value from theresponse property for the response status - info
removed the
unsupported_media_typeenum value from theresponse property for the response status - info
removed the
unsupported_media_typeenum value from theresponse property for the response status - info
removed the
unsupported_media_typeenum value from theresponse property for the response status - info
removed the
unsupported_media_typeenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
validation_failedenum value from theresponse property for the response status - info
removed the
validation_failedenum value from theresponse property for the response status - info
removed the
validation_failedenum value from theresponse property for the response status - info
removed the
validation_failedenum value from theresponse property for the response status - info
removed the
validation_failedenum value from theresponse property for the response status - info
removed the
validation_failedenum value from theresponse property for the response status
This list may be incomplete.
- breaking
- breaking
the response property
became optional for the status - warning
added the new
upstream_unavailableenum value to theresponse property for the response status - warning
added the new
upstream_unavailableenum value to theresponse property for the response status - warning
added the new
upstream_unavailableenum value to theresponse property for the response status - warning
added the new
upstream_unavailableenum value to theresponse property for the response status - warning
added the new
upstream_unavailableenum value to theresponse property for the response status - warning
added the new
upstream_unavailableenum value to theresponse property for the response status - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the non-success response with the status
- info
removed the non-success response with the status
- info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status - info
removed the
upstream_errorenum value from theresponse property for the response status
- breaking