Lattice.Hub

MCP Server / Tool registry.

Default Base URL: http://127.0.0.1:8090. Management APIs require Authorization (token from login).

MCP Registry

MCP Server / Tool registry metadata—not an execution engine.

GET/ai/mcp/v1/serversAuth required

List MCP servers

List MCP servers.

Parameters

Authorizationheader · stringrequired
Token from login.
namequery · stringoptional
name
namespacequery · stringoptional
namespace
businessquery · stringoptional
business
departmentquery · stringoptional
department
protocolquery · stringoptional
protocol
offsetquery · uint32optional
offset
limitquery · uint32optional
limit
backend_typequery · stringoptional
backend_type
backend_service_namespacequery · stringoptional
backend_service_namespace
backend_service_namequery · stringoptional
backend_service_name

Request

curl -sS 'http://127.0.0.1:8090/ai/mcp/v1/servers?namespace=default' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success",
  "servers": [{ "name": "docs-mcp", "namespace": "default" }]
}

POST/ai/mcp/v1/serversAuth required

Create MCP servers

Create MCP servers; body fields follow runtime / annotations.

Parameters

Authorizationheader · stringrequired
Token from login.
(body)body · MCPServer[]required
Request body is a JSON array of MCPServer: [{...}, ...]. Fields below are the full per-item schema (including nested).
idbody · stringoptional
id
namebody · stringrequired
name
namespacebody · stringrequired
namespace
portsbody · stringoptional
ports
businessbody · stringoptional
business
departmentbody · stringoptional
department
descriptionbody · stringoptional
description
referencebody · stringoptional
reference
protocolbody · stringoptional
protocol
export_tobody · stringoptional
export_to
backend_typebody · stringoptional
backend_type indicates how this MCP server reaches its backend. Supported values: service, address.
backend_service_namespacebody · stringoptional
backend_service_namespace is set when backend_type is service.
backend_service_namebody · stringoptional
backend_service_name is set when backend_type is service.
backend_addressbody · stringoptional
backend_address is set when backend_type is address.

Response fields

codebody · uint32required
Business code; success is usually 200000.
infobody · stringoptional
Info message.
mCPServerbody · MCPServeroptional
MCPServer entity fields (batch APIs nest under responses[]).
- idbody · stringoptional
  id
- namebody · stringoptional
  name
- namespacebody · stringoptional
  namespace
- portsbody · stringoptional
  ports
- businessbody · stringoptional
  business
- departmentbody · stringoptional
  department
- descriptionbody · stringoptional
  description
- revisionbody · stringoptional
  revision
- flagbody · uint32optional
  flag
- referencebody · stringoptional
  reference
- protocolbody · stringoptional
  protocol
- ctimebody · stringoptional
  ctime
- mtimebody · stringoptional
  mtime
- export_tobody · stringoptional
  export_to
- backend_typebody · stringoptional
  backend_type indicates how this MCP server reaches its backend. Supported values: service, address.
- backend_service_namespacebody · stringoptional
  backend_service_namespace is set when backend_type is service.
- backend_service_namebody · stringoptional
  backend_service_name is set when backend_type is service.
- backend_addressbody · stringoptional
  backend_address is set when backend_type is address.

Request

curl -sS -X POST 'http://127.0.0.1:8090/ai/mcp/v1/servers' \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[{"name":"docs-mcp","namespace":"default"}]'

Response example

{
  "code": 200000,
  "info": "execute success",
  "amount": 1
}

GET/ai/mcp/v1/server/toolsAuth required

List MCP tools

List tools under an MCP server.

Parameters

Authorizationheader · stringrequired
Token from login.
server_idquery · stringoptional
MCP Server ID.
namespacequery · stringoptional
Namespace.

Request

curl -sS 'http://127.0.0.1:8090/ai/mcp/v1/server/tools?server_id=<id>' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success",
  "tools": [{ "name": "search_docs" }]
}

PUT/ai/mcp/v1/serversAuth required

Update MCP servers

Update MCP servers.

Parameters

Authorizationheader · stringrequired
Token from login.
(body)body · MCPServer[]required
JSON array of MCPServer; fields below are per-item.
idbody · stringoptional
id
namebody · stringoptional
name
namespacebody · stringoptional
namespace
portsbody · stringoptional
ports
businessbody · stringoptional
business
departmentbody · stringoptional
department
descriptionbody · stringoptional
description
referencebody · stringoptional
reference
protocolbody · stringoptional
protocol
export_tobody · stringoptional
export_to
backend_typebody · stringoptional
backend_type
backend_service_namespacebody · stringoptional
backend_service_namespace
backend_service_namebody · stringoptional
backend_service_name
backend_addressbody · stringoptional
backend_address

Response fields

codebody · uint32required
Business code.
infobody · stringoptional
Info.
MCPServerbody · MCPServeroptional
Entity fields.
- idbody · stringoptional
  id
- namebody · stringoptional
  name
- namespacebody · stringoptional
  namespace
- portsbody · stringoptional
  ports
- businessbody · stringoptional
  business
- departmentbody · stringoptional
  department
- descriptionbody · stringoptional
  description
- revisionbody · stringoptional
  revision
- flagbody · uint32optional
  flag
- referencebody · stringoptional
  reference
- protocolbody · stringoptional
  protocol
- ctimebody · stringoptional
  ctime
- mtimebody · stringoptional
  mtime
- export_tobody · stringoptional
  export_to
- backend_typebody · stringoptional
  backend_type
- backend_service_namespacebody · stringoptional
  backend_service_namespace
- backend_service_namebody · stringoptional
  backend_service_name
- backend_addressbody · stringoptional
  backend_address

Request

curl -sS -X PUT 'http://127.0.0.1:8090/ai/mcp/v1/servers' \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[]'

Response example

{
  "code": 200000,
  "info": "execute success"
}

POST/ai/mcp/v1/servers/deleteAuth required

Delete MCP servers

Delete MCP servers.

Parameters

Authorizationheader · stringrequired
Token from login.
idsbody · string[]optional
MCP Server ID 列表。
namespacebody · stringoptional
命名空间。

Response fields

codebody · uint32required
Business code.
infobody · stringoptional
Info.
MCPServerDeleteRequestbody · MCPServerDeleteRequestoptional
Entity fields.
- idsbody · string[]optional
  MCP Server ID 列表。
- namespacebody · stringoptional
  命名空间。

Request

curl -sS -X POST 'http://127.0.0.1:8090/ai/mcp/v1/servers/delete' \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[]'

Response example

{
  "code": 200000,
  "info": "execute success"
}

POST/ai/mcp/v1/self-capabilities/probeAuth required

Self-capabilities probe

Internal capability probe.

Parameters

Authorizationheader · stringrequired
Token from login.

Request

curl -sS -X POST 'http://127.0.0.1:8090/ai/mcp/v1/self-capabilities/probe' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success"
}

GET/ai/mcp/v1/sseAuth required

MCP SSE (GET)

MCP transport channel, not Console CRUD.

Parameters

Authorizationheader · stringrequired
Token from login.

Request

curl -sS -X GET 'http://127.0.0.1:8090/ai/mcp/v1/sse' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success"
}

POST/ai/mcp/v1/sseAuth required

MCP SSE (POST)

MCP transport channel.

Parameters

Authorizationheader · stringrequired
Token from login.

Request

curl -sS -X POST 'http://127.0.0.1:8090/ai/mcp/v1/sse' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success"
}

GET/ai/mcp/v1/messageAuth required

MCP Message (GET)

MCP message channel.

Parameters

Authorizationheader · stringrequired
Token from login.

Request

curl -sS -X GET 'http://127.0.0.1:8090/ai/mcp/v1/message' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success"
}

POST/ai/mcp/v1/messageAuth required

MCP Message (POST)

MCP message channel.

Parameters

Authorizationheader · stringrequired
Token from login.

Request

curl -sS -X POST 'http://127.0.0.1:8090/ai/mcp/v1/message' \
  -H "Authorization: $TOKEN"

Response example

{
  "code": 200000,
  "info": "execute success"
}

MCP Registry

List MCP servers

Create MCP servers

List MCP tools

Update MCP servers

Delete MCP servers

Self-capabilities probe

MCP SSE (GET)

MCP SSE (POST)

MCP Message (GET)

MCP Message (POST)

On this page