Skip to content
EverrunsEverruns
Everruns Cloud is open in early access. Run agents without operating the platform.

Check again whether an OAuth MCP server's sign-in service is reachable, and record the result on the server.

POST
/v1/mcp-servers/{id}/check-connection
curl --request POST \
  --url https://app.everruns.com/api/v1/mcp-servers/example/check-connection

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
id
required
string

Prefixed public identifier

Responses

Section titled “ Responses ”

200

Section titled “200”

Success

Media typeapplication/json

Wrapper that adds API and UI links to a serialized resource.

Uses self_url (not url) for the API link to avoid collision with resources that already have a url field (e.g. McpServer). The allowed_actions array carries state-aware hypermedia links — empty (and omitted from the wire shape) until the underlying resource opts into the convention by overriding ResourceUrlable::allowed_actions.

object
api_key_set
required

Whether an API key has been configured.

boolean
archived_at

Timestamp when the MCP server was archived.

string | null format: date-time
auth_mode

Authentication mode for this MCP server.

string
Allowed values: none api_key oauth
connection_check
One of:

Whether this OAuth preset’s sign-in service was reachable when it was last checked. Present only on OAuth presets.

object
checked_at

When the check ran; absent when it has not run.

string | null format: date-time
host

Host of the request that failed, when the check failed.

string | null
reason

Short, safe explanation of a failed check.

string | null
status
required

Check outcome.

string
Allowed values: ready blocked_by_network_policy unreachable failed not_checked
created_at
required

Timestamp when the MCP server was created.

string format: date-time
deleted_at

Timestamp when the MCP server was deleted.

string | null format: date-time
description

Human-readable description of the MCP server.

string | null
elicitation_policy

Which elicitation modes this server may use (url by default).

string
Allowed values: url url_and_form none
headers

Additional HTTP headers for authentication. Keys are header names, values are header values.

object
key
additional properties
string
id
required

Unique identifier for the MCP server.

string
name
required

Display name of the MCP server.

string
oauth_provider_id

Stable provider id used for user-scoped OAuth connections.

string | null
protocol_mode

Protocol-era adoption policy for the MCP client (auto negotiates).

string
Allowed values: auto 2025-03-26 2025-06-18 2026-07-28
service_connection_provider

Connection provider whose connection on an agent’s service virtual user supplies the service credential instead of an MCP OAuth grant.

string | null
status
required

Current lifecycle status of the MCP server.

string
Allowed values: active disabled archived deleted
transport_type
required

Transport type (currently only HTTP supported).

string
Allowed values: http stdio
updated_at
required

Timestamp when the MCP server was last updated.

string format: date-time
url
required

URL of the MCP server endpoint.

string
allowed_actions

State-aware hypermedia actions the caller can take on this resource next (e.g. cancel, events, update). Omitted from the wire shape when empty so resources that haven’t opted into the convention don’t grow their payloads.

Array<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

  • Error recovery — ErrorResponse.allowed_actions carries rels like retry, retry-later, unarchive, get-existing so the agent knows the right next call after a 4xx/429.
  • Entity hypermedia — WithUrls<T>.allowed_actions carries state-aware rels like cancel, events, self, update on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed rel vocabulary distinguishes them.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null
href

Absolute (preferred) or relative URL the caller may invoke directly. Always present on entity hypermedia actions (WithUrls<T>.allowed_actions); optional on error-recovery actions (ErrorResponse.allowed_actions) where the matching operation_id is enough and the URI is implicit from the failed call.

string | null
method

HTTP method to use against href. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null
operation_id

OpenAPI operationId the caller should invoke. Lets an MCP client resolve the call without parsing href.

string | null
rel
required

Link relation describing the action. Examples: self, cancel, pause, resume, events, retry, retry-later, unarchive, get-existing, delete, update.

string
schema_ref

OpenAPI $ref to the request-body schema, when the action takes one (e.g. #/components/schemas/UpdateSessionRequest). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null
self_url
required

Full API endpoint URL for this resource.

string
ui_link
required

Alias for view_url, used by command and MCP outputs.

string
view_url
required

Full UI URL for viewing this resource.

string
Example
{
  "auth_mode": "none",
  "connection_check": {
    "host": "mcp.linear.app",
    "status": "ready"
  },
  "description": "Atlassian MCP Server for Jira and Confluence",
  "elicitation_policy": "url",
  "id": "mcp_01933b5a00007000800000000000001",
  "name": "atlassian-mcp-server",
  "protocol_mode": "auto",
  "service_connection_provider": "github",
  "status": "active",
  "transport_type": "http",
  "url": "https://mcp.atlassian.com/v1/mcp",
  "allowed_actions": [
    {
      "method": "POST"
    }
  ]
}

404

Section titled “404”

MCP server not found