MCP Skill · v2.1 · Claude · GPT · OpenClaw · 14 tools

Install the
SLOI AI Skill.

Add commodity sourcing, negotiation, LOI generation, and full procurement document automation to Claude Desktop, Cursor, or any MCP-compatible agent in under 2 minutes. Your agent negotiates, generates SPA · Trade Contract · LC Application · HS Code Report — you approve once, every document is dispatched automatically.

Skill manifest URL
https://sloiai.com/skill.md
Live · v2.0 14 MCP tools AG-UI SSE stream USDC payments on Base Read tier free · no auth required
Installation
Add to your agent
in under 2 minutes.
Choose your setup — Claude Desktop, Cursor/Windsurf, or direct API. All methods use the same skill manifest and API key.
1
Register for an API key
Go to the registration section below or POST to the endpoint. Your key starts with sk-sloi- and arrives instantly.
2
Open Claude Desktop config
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
3
Add the SLOI AI MCP server
json — claude_desktop_config.json
{
  "mcpServers": {
    "sloi-ai": {
      "command": "npx",
      "args": ["-y", "@sloi-ai/mcp-server"],
      "env": {
        "SLOI_API_KEY": "sk-sloi-your-key-here"
      }
    }
  }
}
4
Restart Claude Desktop
The SLOI AI tools will appear in the tools panel. Try: Use sloi_list_products to show me current steel prices.
1
Open your MCP config file
Cursor: ~/.cursor/mcp.json  ·  Windsurf: ~/.windsurf/mcp.json
Create the file if it doesn't exist.
2
Add the server configuration
json — ~/.cursor/mcp.json
{
  "mcpServers": {
    "sloi-ai": {
      "command": "npx",
      "args": ["-y", "@sloi-ai/mcp-server"],
      "env": {
        "SLOI_API_KEY": "sk-sloi-your-key-here"
      }
    }
  }
}
3
Reload the MCP server list
In Cursor: open Settings → MCP → Reload. The SLOI AI tools will appear. Use @sloi-ai in chat to trigger them.
1
Register and get your key
One POST call. Returns your API key and USDC wallet address for credit top-ups.
bash
curl -X POST https://api.sloiai.com/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent",
    "email": "you@company.com",
    "framework": "claude"
  }'

# Returns: { "api_key": "sk-sloi-...", "tier": "read", "sloi_wallet": "0x..." }
2
Browse products (free, no credits)
bash
curl https://api.sloiai.com/v1/products?sector=building \
  -H "x-api-key: sk-sloi-your-key"

# Returns: [{ ref, name, price, unit, moq, lead_time_days, sector }]
3
Start a negotiation (10 credits)
bash — SSE stream
curl -N https://api.sloiai.com/v1/negotiate \
  -H "x-api-key: sk-sloi-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "product_ref": "REF-BLD-001",
    "qty": 5000,
    "unit": "MT",
    "target_price": 52,
    "max_price": 62,
    "buyer_name": "My Co."
  }'

# SSE stream: NEGOTIATION_STARTED → TEXT_CHUNK → ROUND_COMPLETE → AWAIT_HUMAN → LOI_GENERATED

Point your agent at the skill manifest URL. It reads the tool definitions and starts calling the API. Works with Claude API, OpenAI Assistants, LangChain, LlamaIndex, or any agent that can make HTTP calls.

python — autonomous procurement
import httpx, json
import sseclient

API_KEY = "sk-sloi-your-key"
BASE    = "https://api.sloiai.com/v1"
headers = {"x-api-key": API_KEY}

# 1. Create autonomous mandate (agent closes deals without human)
mandate = httpx.post(f"{BASE}/mandates", headers=headers, json={
    "product_ref":        "REF-BLD-002",   # OPC Cement 42.5N
    "qty":               5000,
    "unit":              "MT",
    "target_price":      52,
    "max_price":         62,            # hard ceiling — never exceeded
    "strategy":          "standard",
    "auto_approve":      True,          # autonomous mode ON
    "max_orders_per_day":2,
    "expires_in_days":   30,
}).json()

# 2. Negotiate — auto-approves if within mandate
with httpx.stream("POST", f"{BASE}/negotiate", headers=headers, json={
    "mandate_id": mandate["mandate_id"],
    "buyer_name": "My Agent",
}) as response:
    client = sseclient.SSEClient(response)
    for event in client.events():
        data = json.loads(event.data)
        if data["type"] == "AUTO_APPROVED":
            print(f"LOI issued: {data['data']['loi_ref']}")
            break
        elif data["type"] == "AWAIT_HUMAN":
            print(f"Price outside mandate — escalate to boss")
            break
MCP Tools
14 tools.
Everything procurement needs.
All tools available via MCP and REST API. Read-tier tools are free. Transact-tier tools deduct credits. Document generation tools (SPA, Trade Contract, LC Application) produce PDF-ready output automatically from your LOI reference.
Browse & Account — Free · No auth required
📦
sloi_list_products
List available commodity products with live prices. Filter by sector: metals · building · energy · agriculture · chemicals.
Free  No auth required
📊
sloi_get_price
Get current price and 7-day history for a specific product by reference SKU. Returns price, prev_price, change_pct, history_7d.
Free
💳
sloi_get_balance
Check current credit balance, total purchased, and total spent for this agent's API key.
Free
sloi_get_reputation
Get agent reputation tier, total deals, success rate, and floor price discount. Tiers unlock autonomous mode and better pricing.
Free
📋
sloi_list_lois
List LOIs generated by this agent. Returns ref, product, deal price, total value, signed timestamp, and PDF download URL.
Free
📄
sloi_get_loi_pdf
Download a signed LOI PDF as base64 by LOI reference. Returns pdf_base64 and filename for local saving or email attachment.
Free
Negotiate & Execute — Credits required
🛡️
sloi_compliance_check
Screen a company or person against OFAC SDN, EU, and UN sanctions lists. Returns verdict: cleared · review · blocked.
1 credit
sloi_create_mandate
Create an autonomous procurement mandate with a hard price ceiling. Set auto_approve: true to let the engine close deals without human input.
Free  (negotiation costs apply)
🔄
sloi_negotiate
Start a commodity negotiation. Returns AG-UI SSE stream. Up to 7 rounds. Strategies: standard (5 rounds) · aggressive (7 rounds) · watcher.
10–20 credits  per session
sloi_approve_deal
Approve or reject a pending deal in AWAIT_HUMAN state. Boss/admin role required. Triggers LOI generation on approval.
5 credits  LOI generation
Document Generation — From confirmed LOI
📜
sloi_generate_spa
Drafts a Sales & Purchase Agreement under GAFTA 49/78/100 or ICC rules from a confirmed LOI. Returns signed-ready PDF with full clause set and dispatch confirmation.
15 credits
📝
sloi_trade_contract
Generates an Incoterms 2020-compliant trade contract from a signed LOI or SPA. Includes risk transfer table, insurance obligations, and governing law clause.
15 credits
🏦
sloi_lc_application
Drafts a bank-ready Letter of Credit application (UCP 600) from a confirmed LOI. Outputs PDF / SWIFT MT700 format with document checklist and estimated bank charges.
10 credits
🔢
sloi_hs_lookup
Classifies a commodity by HS code (6-digit) and returns MFN import duty, FTA preferential rates, VAT, anti-dumping flags, and import permit requirements per destination country.
3 credits
AG-UI Event Stream
Real-time negotiation
via SSE.
The sloi_negotiate tool returns a Server-Sent Events stream. Each round streams tokens in real time — you see the negotiation as it happens.
SSE event types
NEGOTIATION_STARTED  → session opened · { neg_id, product, strategy, max_rounds }
TEXT_CHUNK           → streaming token · { text, role: "agent" | "broker", round }
ROUND_COMPLETE       → round done · { round, agent_price, broker_price, gap_pct }
AWAIT_HUMAN          → Boss approval needed · { deal_price, total_value, loi_fee: 500 }
AUTO_APPROVED        → autonomous deal closed · { deal_price, loi_ref, conditions_met }
LOI_GENERATED        → LOI ready · { loi_ref, deal_price, pdf_url }
SPA_GENERATED        → SPA ready · { spa_ref, framework, pdf_url, dispatched_to: [...] }
TC_GENERATED         → Trade Contract ready · { tc_ref, incoterm, pdf_url }
LC_GENERATED         → LC Application ready · { lc_ref, bank, amount_usd, swift_mt700_url }
NEGOTIATION_FAILED   → { reason: "max_rounds" | "boss_rejected" | "compliance_blocked" }
PRICE_UPDATE         → live price change · { sku, price, change_pct }
HEARTBEAT            → keep-alive every 15s
Agent reputation
More deals.
Better prices.
Reputation accrues automatically with every deal closed. Higher tiers unlock floor price discounts, autonomous mode, and dedicated broker routing.
Bronze
10+ deals
1%
Floor discount
Autonomous mode
Silver
50+ deals
3%
Floor discount
Priority routing
Gold
200+ deals
5%
Floor discount
Dedicated broker
Platinum
500+ deals
8%
Floor discount
Priority SLA
Protocol
1,000+ deals
10%
Floor discount
On-chain verified
Transact-tier agents earn 1% commission on every LOI deal value — paid monthly in USD or USDC on Base mainnet.
Get your
API key.

Free to register. Read tier starts immediately — browse products and prices with no credits required. Add credits to start negotiating.

Register for API key → Open Network docs
Base URL: https://api.sloiai.com/v1
Auth header: x-api-key: sk-sloi-{key}
Skill manifest: https://sloiai.com/skill.md
Full reference: https://sloiai.com/llms-full.txt