Give your agent an identity and a wallet in one MCP call.

// Claude: claude_desktop_config.json, or Settings > Connectors > Add custom connector
// ChatGPT: Settings > Connectors > Create, then paste the same URL
{
  "mcpServers": {
    "sils": {
      "type": "http",
      "url": "https://mcp.silsacommerce.com/mcp"
    }
  }
}

// npm install @sils/sdk
import { Sils } from "@sils/sdk";

const sils = new Sils({
  apiKey: process.env.SILS_SECRET_KEY, // sk_test_... on testnet
  baseUrl: "https://api.silsacommerce.com/v1",
});

const me = await sils.account.retrieve();
console.log(me.mode); // "test"

# pip install sils
import os
from sils import Sils

sils = Sils(
    api_key=os.environ["SILS_SECRET_KEY"],  # sk_test_... on testnet
    base_url="https://api.silsacommerce.com/v1",
)

me = sils.account.retrieve()
print(me.mode)  # "test"

curl https://api.silsacommerce.com/v1/account \
  -H "Authorization: Bearer $SILS_SECRET_KEY"

# { "object": "account", "mode": "test", "networks": ["eip155:84532", ...] }

// tools/call: sils.start_verification
{ "name": "rob", "level": "L2" }

// result.structuredContent
{
  "session": "ver_7Qm2xK",
  "verificationUrl": "https://verify.silsacommerce.com/s/ver_7Qm2xK",
  "expiresIn": 900
}
// result.content[0].text
// "Tap this link to verify."

// tools/call: sils.status, after the owner returns
{ "session": "ver_7Qm2xK" }
// => { "state": "verified", "name": "rob.revo", "level": "L2" }

const v = await sils.verifications.create(
  { name: "rob", level: "L2" },
  { idempotencyKey: crypto.randomUUID() },
);
// Send the owner to v.verificationUrl. Then poll, or listen for identity.verified.
const done = await sils.verifications.retrieve(v.session);
console.log(done.state, done.name); // "verified" "rob.revo"

import uuid

v = sils.verifications.create(
    name="rob", level="L2",
    idempotency_key=str(uuid.uuid4()),
)
# Send the owner to v.verification_url. Then poll, or listen for identity.verified.
done = sils.verifications.retrieve(v.session)
print(done.state, done.name)  # verified rob.revo

curl https://api.silsacommerce.com/v1/verifications \
  -H "Authorization: Bearer $SILS_SECRET_KEY" \
  -H "Idempotency-Key: 5d1f0c2a-8b7e-4c55-9a1d-2f3e6b7c8d90" \
  -H "Content-Type: application/json" \
  -d '{ "name": "rob", "level": "L2" }'

# { "session": "ver_7Qm2xK", "verificationUrl": "https://verify.silsacommerce.com/s/ver_7Qm2xK" }

curl https://api.silsacommerce.com/v1/verifications/ver_7Qm2xK \
  -H "Authorization: Bearer $SILS_SECRET_KEY"

// tools/call: sils.create_agent
{
  "parent": "rob.revo",
  "label": "shopping",
  "purpose": "Buy books and household items",
  "policy": {
    "perTx": "25.00 USDC",
    "perMonth": "200.00 USDC",
    "categories": ["retail", "books"],
    "counterpartyFacets": ["entity.verified"],
    "approvalOver": "40.00 USDC",
    "expires": "2027-01-01"
  }
}

// result, after the owner approves with a passkey
{
  "agent": "shopping.rob.revo",
  "status": "active",
  "policyHash": "0x9c1e...4b7a",
  "explorer": "https://explorer.example/tx/0x31d0...a2"
}

const agent = await sils.agents.create({
  parent: "rob.revo",
  label: "shopping",
  policy: {
    perTx: "25.00",
    perMonth: "200.00",
    asset: "USDC",
    categories: ["retail", "books"],
    counterpartyFacets: ["entity.verified"],
    approvalOver: "40.00",
    expires: "2027-01-01",
  },
}, { idempotencyKey: crypto.randomUUID() });

console.log(agent.name, agent.policyHash); // shopping.rob.revo 0x9c1e...4b7a

agent = sils.agents.create(
    parent="rob.revo",
    label="shopping",
    policy={
        "per_tx": "25.00",
        "per_month": "200.00",
        "asset": "USDC",
        "categories": ["retail", "books"],
        "counterparty_facets": ["entity.verified"],
        "approval_over": "40.00",
        "expires": "2027-01-01",
    },
    idempotency_key=str(uuid.uuid4()),
)
print(agent.name)  # shopping.rob.revo

curl https://api.silsacommerce.com/v1/agents \
  -H "Authorization: Bearer $SILS_SECRET_KEY" \
  -H "Idempotency-Key: 0b8e7f1c-3d2a-4e69-8f10-7a6b5c4d3e21" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": "rob.revo",
    "label": "shopping",
    "policy": { "perTx": "25.00", "perMonth": "200.00", "asset": "USDC",
                "categories": ["retail", "books"],
                "counterpartyFacets": ["entity.verified"],
                "approvalOver": "40.00", "expires": "2027-01-01" }
  }'

// tools/call: sils.pay  (annotated destructive)
{
  "agent": "shopping.rob.revo",
  "resource": "https://acme.example/api/v1/report",
  "maxAmount": "25.00 USDC"
}

// result.structuredContent
{
  "status": "settled",
  "amount": "24.00 USDC",
  "payTo": "sales.acme.revo",
  "receipt": "rcpt_4hT9wQ",
  "explorer": "https://explorer.example/tx/0x8a4c...19"
}
// result.content[0].text
// "Paid 24.00 USDC to sales.acme.revo. Proof valid. Owner verified. Within policy."

// sils.fetch wraps fetch(). On 402 it pays within policy and retries once.
const res = await sils.fetch("https://acme.example/api/v1/report", {
  agent: "shopping.rob.revo",
  maxAmount: "25.00",
});

const report = await res.json();
const receipt = sils.receipts.fromResponse(res); // decoded PAYMENT-RESPONSE
console.log(receipt.amount, receipt.payTo);      // 24.00 USDC sales.acme.revo

res = sils.fetch(
    "https://acme.example/api/v1/report",
    agent="shopping.rob.revo",
    max_amount="25.00",
)
report = res.json()
receipt = sils.receipts.from_response(res)  # decoded PAYMENT-RESPONSE
print(receipt.amount, receipt.pay_to)       # 24.00 USDC sales.acme.revo

# 1. Ask for the resource. The merchant answers 402.
curl -i https://acme.example/api/v1/report
# HTTP/1.1 402 Payment Required
# PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6Mi...

# 2. Have SILS build the payment for the agent, within policy.
curl https://api.silsacommerce.com/v1/payments \
  -H "Authorization: Bearer $SILS_SECRET_KEY" \
  -H "Idempotency-Key: 9e2d4b6a-1c3f-4a5e-b7d9-0f1e2d3c4b5a" \
  -H "Content-Type: application/json" \
  -d '{ "agent": "shopping.rob.revo", "paymentRequired": "eyJ4NDAy..." }'
# { "paymentSignature": "eyJ4NDAyVmVyc2lvbiI6Mi..." }

# 3. Retry with the payload.
curl -i https://acme.example/api/v1/report \
  -H "PAYMENT-SIGNATURE: eyJ4NDAyVmVyc2lvbiI6Mi..."
# HTTP/1.1 200 OK
# PAYMENT-RESPONSE: eyJzdWNjZXNzIjp0cnVl...

POST /mcp HTTP/1.1
Host: mcp.silsacommerce.com

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://mcp.silsacommerce.com/.well-known/oauth-protected-resource"

// GET https://mcp.silsacommerce.com/.well-known/oauth-protected-resource
{
  "resource": "https://mcp.silsacommerce.com/mcp",
  "authorization_servers": ["https://auth.silsacommerce.com"],
  "scopes_supported": ["identity:read", "agents:write", "proofs:create", "payments:create"],
  "bearer_methods_supported": ["header"]
}

GET https://auth.silsacommerce.com/authorize
  ?response_type=code
  &client_id=https%3A%2F%2Fclient.example%2Fmetadata.json
  &redirect_uri=https%3A%2F%2Fclient.example%2Fcallback
  &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
  &code_challenge_method=S256
  &resource=https%3A%2F%2Fmcp.silsacommerce.com%2Fmcp
  &scope=agents%3Awrite+payments%3Acreate

import express from "express";
import { requireProof, verifyPayment, confirmOrder } from "@sils/sdk/merchant";

const app = express();

app.get(
  "/api/v1/report",
  requireProof({
    payTo: "sales.acme.revo",
    amount: "24.00",
    asset: "USDC",
    facets: ["human.verified", "age.over.21", "jurisdiction.in:US"],
  }),
  async (req, res) => {
    const payment = await verifyPayment(req); // facilitator POST /verify
    const report = await buildReport();
    const receipt = await confirmOrder(payment); // facilitator POST /settle
    res.set("PAYMENT-RESPONSE", receipt.header).json(report);
  },
);

import { Hono } from "hono";
import { requireProof, verifyPayment, confirmOrder } from "@sils/sdk/merchant/hono";

const app = new Hono();

app.get(
  "/api/v1/report",
  requireProof({ payTo: "sales.acme.revo", amount: "24.00", asset: "USDC",
                 facets: ["human.verified", "age.over.21"] }),
  async (c) => {
    const payment = await verifyPayment(c.req.raw);
    const report = await buildReport();
    const receipt = await confirmOrder(payment);
    c.header("PAYMENT-RESPONSE", receipt.header);
    return c.json(report);
  },
);

export default app;

// app/api/v1/report/route.ts
import { requireProof, verifyPayment, confirmOrder } from "@sils/sdk/merchant/next";

const terms = {
  payTo: "sales.acme.revo",
  amount: "24.00",
  asset: "USDC",
  facets: ["human.verified", "age.over.21"],
};

export async function GET(req: Request) {
  const challenge = await requireProof(req, terms);
  if (challenge) return challenge; // 402 with PAYMENT-REQUIRED

  const payment = await verifyPayment(req);
  const report = await buildReport();
  const receipt = await confirmOrder(payment);

  return Response.json(report, {
    headers: { "PAYMENT-RESPONSE": receipt.header },
  });
}

// POST https://acme.example/webhooks/sils
// SILS-Signature: t=1791043200,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd
{
  "id": "evt_3Nc81z",
  "type": "settlement.finalized",
  "created": "2026-10-03T14:00:00Z",
  "data": {
    "settlement": "stl_Vb82kQ",
    "amount": "24000000",
    "payTo": "sales.acme.revo",
    "facets": ["human.verified", "age.over.21"]
  }
}

{
  "error": {
    "type": "policy_error",
    "code": "spend_cap_exceeded",
    "message": "Shopping tried to spend 250.00 USDC. The cap is 200.00 USDC. Blocked.",
    "param": "amount",
    "agent": "shopping.rob.revo",
    "requestId": "req_9Lx2Qe",
    "docUrl": "https://docs.silsacommerce.com/errors/spend_cap_exceeded"
  }
}

# SILS
> Verified owners, agent policy, private proofs and x402 payment for AI agents.

## Quickstart
- [Connect the MCP server](https://docs.silsacommerce.com/quickstart/connect.md)
- [Verify the owner](https://docs.silsacommerce.com/quickstart/verify.md)
- [Create an agent](https://docs.silsacommerce.com/quickstart/agents.md)
- [Pay a 402 endpoint](https://docs.silsacommerce.com/quickstart/pay.md)

## Reference
- [MCP tools](https://docs.silsacommerce.com/reference/mcp-tools.md)
- [sils-proof scheme](https://docs.silsacommerce.com/reference/sils-proof.md)
- [Facets](https://docs.silsacommerce.com/reference/facets.md)