Supply Chain Agent MCP

This is a lightweight service page, not a FastAPI Swagger UI.

Endpoints

http://sca-test.mcp.hicloudapp.com/health - service health JSON
http://sca-test.mcp.hicloudapp.com/tools - MCP tool metadata JSON
http://sca-test.mcp.hicloudapp.com/mcp - Streamable HTTP MCP endpoint

Server Config

MCP_HOST: 0.0.0.0
MCP_PORT: 8000
AGENT_BASE_URL: https://sca.app.hicloudapp.com
DB_POOL_MAX_SIZE: 20

Quick Checks

curl http://sca-test.mcp.hicloudapp.com/health
curl http://sca-test.mcp.hicloudapp.com/tools

Tools

search_zoho_supply_records

Search Zoho sourcing records by exact CAS or complete product name.

Auth required: yes

Parameters

query: Required. Exact CAS number or complete product name.
limit: Optional. Maximum rows to return, default 10.
database: Optional. Zoho database/source id, default from env.
department: Optional. Zoho department, default from env.

describe_zoho_supply_schema

Describe the Zoho sourcing schema and sample rows.

Auth required: yes

Parameters

database: Optional. Zoho database/source id, default from env.
department: Optional. Zoho department, default from env.

submit_supply_chain_query

Submit a supply-chain query to the deployed agent queue.

Auth required: yes

Parameters

message: Required. User query/request to send to the agent.
audience: Optional for single-role users; required for multi-role users.
force_refresh: Optional. Bypass report history and per-CAS data reuse, default false.
quantity: Optional positive customer demand. Ordinary search runs first.
unit: Quantity unit, e.g. kg or g. Provide together with quantity.

get_supply_chain_result

Read status and final output for a submitted task_id from PostgreSQL.

Auth required: yes

Parameters

task_id: Required. The task_id returned by submit_supply_chain_query.
with_raw: Optional. Include raw row fields, default false.

list_my_supply_chain_tasks

List readable tasks with CAS, status, query text, and timestamps.

Auth required: yes

Parameters