FetchRemoteMcpTools

Updated at:

Retrieves the tool list from a remote MCP server.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /mcptools HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

The request body parameters.

network

object

No

The request body parameters.

mode

string

No

The network access mode of the MCP service. Valid values: public and vpc.

public

vpcId

string

No

The VPC ID.

vpc-xxx

vswId

string

No

The vSwitch ID.

vsw-xxx

accessIp

string

No

The IP address used to access the MCP service over the VPC network.

10.0.0.12

accessPort

integer

No

The port used to access the MCP service over the VPC network. Valid values: 1 to 65535.

8080

securityGroupId

string

No

The security group ID.

sg-xxx

gatewayId

string

No

The gateway ID.

gw-xxx

mcpServerId

string

No

The MCP Server instance ID.

mcp-xxx

region

string

No

The region where the VPC network resides.

cn-hangzhou

connection

object

Yes

The request body parameters.

platform

string

No

The MCP service platform type. Valid values: AIGateway and Custom.

Custom

transport

string

Yes

The MCP service transport protocol. Valid values: http and sse.

http

endpoint

string

Yes

The access endpoint of the MCP service.

https://example.com/mcp

timeout

integer

No

The timeout period for requests to the MCP service. Unit: milliseconds.

5000

auth

object

No

The request body parameters.

type

string

No

bearer

keyInfo

object

No

{"token":"example-token"}

string

No

example-token

Response elements

Element

Type

Description

Example

object

The response parameters.

requestId

string

The request ID.

0B9377D9-C56B-5C2E-A8A4-************

tools

string

The raw tools/list response returned by the remote MCP service.

{"jsonrpc":"2.0","id":1,"result":{"tools":[]}}

Examples

Success response

JSON format

{
  "requestId": "0B9377D9-C56B-5C2E-A8A4-************",
  "tools": "{\"jsonrpc\":\"2.0\",\"id\":1,\"result\":{\"tools\":[]}}"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.