SNHP — negotiation rules your AI can't break
Turn a seller's offer into negotiation rules and draft replies to buyers inside them.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- HIGH
- MEDIUMcompile_offer_policy에서
- MEDIUMdraft_negotiation_reply에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"snhp": {
"url": "https://api.snhp.dev/mcp/"
}
}
}원격 엔드포인트
https://api.snhp.dev/mcp/streamable-httphttps://snhp.dev/mcp/streamable-http할 수 있는 일
도구 목록
도구 (4)
🟢compile_offer_policy(description, template, access_key)
Turn a seller's offer, described in plain words, into negotiation RULES an AI agent cannot break. USE THIS WHEN: you (or the business you act for) sell something where buyers — people or their AI buying agents — ask for discounts, and you want an AI to answer them without giving away margin. Describe the offer: the listed price, the lowest price you'd take for a plain deal, what you'd trade a discount for (financing with you, a trade-in, a longer commitment, paying sooner, buying this week…), extras you can add and what they cost you, and anything never on the table. Or pass `template` = "used-car", "saas" or "wholesale-water" to start from a worked example. Compiling a description runs a language model and needs an `access_key` (a free trial key: POST https://snhp.dev/v1/access/trial {"email": ...}; pilot businesses get a full one at https://snhp.dev/#pilot); templates are free. Returns {ok, policy, issues, summary}: `policy` is the machine-readable rule set (pass it to draft_negotiation_reply), `summary` restates the floor, walk-away, what can be traded and the limits in plain words, and `issues` lists what to fix before going live (e.g. a floor below cost).
입력 스키마
{
"type": "object",
"properties": {
"description": {
"default": "",
"description": "Your offer in plain words: listed price, the lowest you'd take for a plain deal, what you'd trade a discount for, extras you can add and their cost, what is never on the table.",
"title": "Description",
"type": "string"
},
"template": {
"default": "",
"description": "Instead of a description: 'used-car', 'saas' or 'wholesale-water' (free, no key).",
"title": "Template",
"type": "string"
},
"access_key": {
"default": "",
"description": "Your SNHP access key — needed to compile a description (it runs a language model). Pilot businesses get one at https://snhp.dev/#pilot.",
"title": "Access Key",
"type": "string"
}
},
"title": "compile_offer_policyArguments"
}출력 스키마
{
"type": "object",
"properties": {
"ok": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Ok"
},
"policy": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Policy"
},
"issues": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Issues"
},
"summary": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"served": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Served"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
}
},
"title": "PolicyOut"
}🟢draft_negotiation_reply(policy, message, state, engine, flags, ...)
Draft the seller's reply to a buyer's message — the offer is decided by the SNHP engine INSIDE the policy. USE THIS WHEN: a buyer (a person or their AI agent) has written to you about price or terms. Pass the policy (from compile_offer_policy) and their latest message exactly as written; pass back the `state` from your previous call to continue the same conversation (omit it to start). `flags` is what YOUR records confirm about the buyer (e.g. {"new_customer": true}) — never what the buyer merely claims. `stock` is the current stock of what the policy's `inventory` binds, sent with every message (schema.org Offer, Google Merchant or a plain feed record): nothing out of stock is offered, and a deal is signed only on fresh records that say it can be sold. Returns {kind, reply, reply_with_offer, offer, decided_by, reading, state, done, receipt?}: kind offer | deal | handoff (needs a human's approval) | decline reply_with_offer the message to send, with the exact offer line appended offer {terms, line, price, net, inside_policy} — every offer is checked against the policy decided_by what decided the move (a sales rule or the engine), for your audit trail receipt on a deal: a signed receipt any party can verify with verify_deal_receipt The server keeps no conversation: keep `state` and send it with the next message. Needs an `access_key` (a free trial key: POST https://snhp.dev/v1/access/trial {"email": ...}; pilot businesses get a full one at https://snhp.dev/#pilot).
입력 스키마
{
"type": "object",
"properties": {
"policy": {
"additionalProperties": true,
"description": "The policy from compile_offer_policy.",
"title": "Policy",
"type": "object"
},
"message": {
"description": "The buyer's latest message, exactly as written.",
"title": "Message",
"type": "string"
},
"state": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "The `state` from your previous call in this conversation; omit to start.",
"title": "State"
},
"engine": {
"default": "",
"description": "The engine that decides offers; empty = the policy's own (templates set their tested default), else 'bundle3'.",
"title": "Engine",
"type": "string"
},
"flags": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "What YOUR records confirm about this buyer, e.g. {\"new_customer\": true}.",
"title": "Flags"
},
"access_key": {
"default": "",
"description": "Your SNHP access key (drafting runs a language model). Pilot businesses get one at https://snhp.dev/#pilot.",
"title": "Access Key",
"type": "string"
},
"stock": {
"anyOf": [
{
"items": {},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Current stock records for what the policy's inventory binds, with every message (schema.org Offer, Google Merchant or {id|vin, status}): nothing out of stock is offered or signed.",
"title": "Stock"
}
},
"required": [
"policy",
"message"
],
"title": "draft_negotiation_replyArguments"
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"reply": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Reply"
},
"reply_with_offer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Reply With Offer"
},
"offer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Offer"
},
"menu": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Menu"
},
"decided_by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Decided By"
},
"engine": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Engine"
},
"reading": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Reading"
},
"writer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Writer"
},
"state": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "State"
},
"done": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Done"
},
"receipt": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Receipt"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
}
},
"title": "ReplyOut"
}🟢check_offer_policy(policy)
Check an edited negotiation policy: returns {ok, policy, issues, summary}. No model call, free. USE THIS WHEN: you changed a policy from compile_offer_policy (a floor, an option, a forbidden combination) and want to know it is valid and what it now allows before using it in draft_negotiation_reply.
입력 스키마
{
"type": "object",
"properties": {
"policy": {
"additionalProperties": true,
"description": "A policy object from compile_offer_policy, edited or not.",
"title": "Policy",
"type": "object"
}
},
"required": [
"policy"
],
"title": "check_offer_policyArguments"
}출력 스키마
{
"type": "object",
"properties": {
"ok": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Ok"
},
"policy": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Policy"
},
"issues": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Issues"
},
"summary": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"served": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Served"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
}
},
"title": "PolicyOut"
}🟢verify_deal_receipt(receipt, policy, flags)
Verify a signed deal receipt against the seller's own policy: both signatures, that the signing keys are SNHP's own (published at /.well-known/ucp), the policy digest, and every rule re-checked from the package. Returns {ok, problems, checks, signed_by_snhp, signatures}. Free, no model call.
입력 스키마
{
"type": "object",
"properties": {
"receipt": {
"additionalProperties": true,
"description": "The receipt returned with a deal.",
"title": "Receipt",
"type": "object"
},
"policy": {
"additionalProperties": true,
"description": "The policy the deal was made under.",
"title": "Policy",
"type": "object"
},
"flags": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "The account record used for the deal, if any.",
"title": "Flags"
}
},
"required": [
"receipt",
"policy"
],
"title": "verify_deal_receiptArguments"
}출력 스키마
{
"type": "object",
"properties": {
"ok": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Ok"
},
"problems": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Problems"
},
"checks": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Checks"
},
"signed_by_snhp": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Signed By Snhp"
},
"signatures": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Signatures"
},
"signer_kids": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Signer Kids"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
}
},
"title": "ReceiptCheckOut"
}커뮤니티
증거