An MCP server that gives AI agents expert-level access to Qeasy's e-commerce financial reconciliation knowledge: 748 production-tested knowledge atoms across 15 finance domains, 15 platform topics and 17 customer cases (topics include boundary/onboarding knowledge, not necessarily live reconciliation support). 82 atoms of general methodology and accounting standards are public today; platform playbooks and customer cases require authorization. Agents search, inspect and fetch exact evidence with Git-traceable citations — then generate the answer themselves. One stateless HTTP endpoint: POST /api/mcp.
The tool surface is discoverable at runtime through MCP `tools/list`. No SDK or generated client is required — any MCP-compatible agent (Claude, Cursor, custom) can connect over plain JSON-RPC.
Hybrid vector + keyword retrieval over the reconciliation knowledge base. Parameters: query (required); product, type filters; limit (1–20, default 8); granularity ('doc' default, or 'atom' for one hit per KA-* knowledge atom); includeMeta (add domain/platform metadata). Returns ranked hits with citation, score and visibility.
Fetch a full document, or a single knowledge atom, by docId, citation (sourcePath#atomId) or atomId. Optional maxChars caps the response for your token budget. Restricted documents return -32403 unless the key is authorized.
List the product × type knowledge domains visible to your identity, with document counts. Free of quota — call it first to decide where to search.
The endpoint is stateless: every request carries its own authentication, so it works from serverless agents and multi-instance deployments alike.
Endpoint: POST https://qeasy.cloud/api/mcp — JSON-RPC 2.0 over MCP Streamable HTTP (stateless mode). GET/DELETE return 405 and no session is maintained.
Authentication is optional. Omit the Authorization header for anonymous access (10 tool calls/day per IP, public knowledge only). Add `Authorization: Bearer qk_live_...` for a standard key (10 calls/day, self-serve at /account) or an authorized key (unlimited + restricted knowledge, granted by Qeasy).
Recommended flow: initialize → tools/list → knowledge_domains (free) → knowledge_search → knowledge_fetch(citation#atomId).
Claude Desktop / Cursor — mcp.json
{
"mcpServers": {
"qeasy-knowledge": {
"url": "https://qeasy.cloud/api/mcp",
"headers": {
"Authorization": "Bearer qk_live_YOUR_KEY"
}
}
}
}Raw JSON-RPC — initialize / tools/list / search / fetch
# 1) handshake
curl -s https://qeasy.cloud/api/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'
# 2) discover tools (schemas + descriptions)
curl -s https://qeasy.cloud/api/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
# 3) search public knowledge (anonymous, no key required)
curl -s https://qeasy.cloud/api/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"knowledge_search","arguments":{"query":"费用按收入占比分摊什么时候合理","granularity":"atom","includeMeta":true}}}'
# 4) authorized key: search restricted playbooks and fetch one atom
curl -s https://qeasy.cloud/api/mcp \
-H 'content-type: application/json' \
-H 'Authorization: Bearer qk_live_YOUR_KEY' \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"knowledge_fetch","arguments":{"citation":"docs/knowledge/platforms/jdpop.md#KA-PARSE-JDPOP-HEADER-001"}}}'Tools return retrieval evidence, never generated prose. The calling agent owns the answer and must cite what it used.
Two tiers and three identities. Registration never raises the quota — only explicit authorization does.
Quota resets daily at 00:00 Asia/Shanghai. The 11th counted call returns JSON-RPC -32029 with data.retryAfter and data.resetAt. knowledge_domains, initialize and tools/list are free.
Every tool call is authenticated, visibility-filtered in SQL, quota-checked and written to an audit log (tool, identity tier, key prefix, IP, latency, status; never the plaintext key or document body).
10 tool calls/day per IP, public knowledge only (currently 82 atoms: expense accounting/allocation, platform onboarding methodology, revenue recognition, VAT & invoicing). Best for trying the endpoint and discovering the tool schema.
Create a key at /account (max 5 active keys per user). 10 calls/day per key, public knowledge only. Use it for stable identity and fixed credentials in your MCP client.
Unlimited calls and the full 748-atom knowledge base (public + restricted: platform playbooks, variance labels, customer cases), with configurable product/type scope and expiry. Issued through Qeasy's admin console; contact us to apply.
This endpoint is intentional about scope: it is a retrieval server, not a general-purpose business API. The following capability families are planned, not available today — do not build against them yet.
Start with a free standard key at /account to explore public knowledge, or apply for an authorized key to unlock the full restricted knowledge base and unlimited calls.