Skip to content
Kindgi

Read a single resource at a remote MCP endpoint

GET
/v1/mcp/endpoints/{endpointId}/resources/{uri}
curl --request GET \
  --url https://example.com/v1/mcp/endpoints/example/resources/example \
  --header 'Authorization: Bearer <token>'

URI path segment is URL-encoded — decoded server-side before dispatch to the endpoint. Returns exactly one content payload (text XOR blob per MCP spec).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
endpointId
required
string
>= 1 characters

MCPEndpointId — deployment-stable string identifier chosen by the caller.

uri
required
string
>= 1 characters

URL-encoded MCP resource URI (e.g. file%3A%2F%2F%2Freadme.md). Decoded server-side before dispatch.

Responses

Section titled “Responses”

200

Section titled “200”

MCP resource content.

Media typeapplication/json
object
uri
required
string
mimeType
string
text
string
blob

Base64-encoded binary payload.

string
Examplegenerated
{
  "uri": "example",
  "mimeType": "example",
  "text": "example",
  "blob": "example"
}

401

Section titled “401”

Missing / malformed / expired / revoked bearer token.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}

404

Section titled “404”

No MCP endpoint or resource with that id.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}

502

Section titled “502”

Remote MCP endpoint failed to serve resources/read.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}