Getting Started

npm install -g slopshop

export SLOPSHOP_KEY=sk-slop-your-key-here

# Sign up for free credits
slop signup

# Natural language (auto-routes to the right tool)
slop "hash hello world"

# Direct tool call
slop call crypto-hash-sha256 --data "hello world"

# Start MCP server for Claude Code / Cursor
slop mcp serve

# Persistent memory (free, 0 credits)
slop memory set mykey "some value"
slop memory get mykey

# 1. Create the chain
curl -X POST https://slopshop.gg/v1/chain/create \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"research-loop","loop":true,"steps":[
    {"agent":"claude","prompt":"Research latest AI infrastructure trends","pass_context":true},
    {"agent":"grok","prompt":"Critique the research, find gaps and contradictions","pass_context":true},
    {"agent":"claude","prompt":"Improve the research based on critique, find new angles","pass_context":true}
  ]}'

# 2. Queue for overnight
POST /v1/chain/queue  {"frequency":"daily"}

# 3. Results auto-stored in free memory
POST /v1/memory-get  {"key":"chain_results"}

1. POST /v1/hive/create       {"name":"product-team","channels":["research","writing","review"]}
2. POST /v1/copilot/scale      {"main_session_id":"product-team","count":5,"roles":["researcher","writer","critic","editor","publisher"]}
3. POST /v1/standup/submit     {"yesterday":"Wrote 3 articles","today":"Review and publish"}
4. POST /v1/knowledge/add      {"subject":"article-1","predicate":"reviewed_by","object":"critic-agent"}
5. POST /v1/governance/propose {"title":"Should we pivot topics?"}

1. POST /v1/router/smart   {"task":"analyze financial data","optimize_for":"cost"}
2. POST /v1/army/deploy    {"task":"analyze","count":10000,"api":"text-word-count"}
3. POST /v1/replay/save    {"name":"big-analysis","events":[...]}
4. POST /v1/proof/merkle   {"data":"...results..."}

1. POST /v1/eval/run             {"agent_slug":"text-word-count","test_cases":[...]}
2. POST /v1/memory-set           {"key":"eval_lessons","value":"accuracy was 95%"}
3. POST /v1/tournament/create    {"name":"best-analyzer","participants":["agent-v1","agent-v2"]}
4. Use chain to loop: eval -> learn -> re-eval

1. GET  /v1/credits/balance
2. POST /v1/credits/buy         {"amount":1000}
3. GET  /v1/analytics/usage

1. POST /v1/teams/create       {"name":"Engineering"}
2. POST /v1/keys/set-budget    {"monthly_budget":50000}
3. GET  /v1/analytics/usage
4. GET  /v1/analytics/cost-forecast
5. POST /v1/webhooks/create    {"url":"https://slack.com/webhook","events":["budget_alert"]}

Authorization: Bearer sk-slop-your-key-here

curl -X POST https://slopshop.gg/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "yourpassword"}'

curl https://slopshop.gg/v1/credits/balance \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl -X POST https://slopshop.gg/v1/credits/buy \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000}'

curl -X POST https://slopshop.gg/v1/credits/transfer \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"to_key": "sk-slop-other-key", "amount": 50}'

{
  "data": { ... tool-specific result ... },
  "meta": {
    "api": "tool-slug",
    "credits_used": 3,
    "balance": 97,
    "latency_ms": 12,
    "engine": "real"
  }
}

{
  "error": {
    "code": "error_code",
    "message": "Human-readable description"
  }
}

# Simple call with inline data
slop call crypto-hash-sha256 --data "hello world"

# Pass JSON body
slop call text-word-count -d '{"text": "Count these words please"}'

# Pipe from file
cat document.txt | slop call llm-summarize

slop pipe content-machine -d '{"topic": "AI agents", "keywords": "automation"}'
slop pipe security-audit -d '{"data": "{}", "domain": "example.com"}'

slop search hash
slop search "json convert"
slop search dns

slop list
slop list --category "Crypto & Security"

slop balance

slop buy 1000

slop health

slop help
slop call --help

pip install slopshop

from slopshop import Slop

client = Slop(api_key="sk-slop-your-key-here")
# Or use SLOPSHOP_KEY environment variable
client = Slop()

result = client.call("crypto-hash-sha256", data="hello world")
print(result["hash"])

results = client.batch([
    ("crypto-hash-sha256", {"data": "hello"}),
    ("crypto-hash-md5", {"data": "hello"}),
    ("crypto-uuid", {}),
])
for r in results:
    print(r)

result = client.pipe("content-machine", topic="AI agents", keywords="automation")
print(result["steps"])

result = client.resolve("llm-summarize", text="Long document...", retries=3)
print(result["summary"])

npm install slopshop

const { Slop } = require('slopshop');

const client = new Slop({ apiKey: 'sk-slop-your-key-here' });
// Or use SLOPSHOP_KEY environment variable
const client = new Slop();

const result = await client.call('crypto-hash-sha256', { data: 'hello world' });
console.log(result.hash);

const results = await client.batch([
  ['crypto-hash-sha256', { data: 'hello' }],
  ['crypto-hash-md5', { data: 'hello' }],
  ['crypto-uuid', {}],
]);
results.forEach(r => console.log(r));

const result = await client.pipe('content-machine', {
  topic: 'AI agents',
  keywords: 'automation',
});
console.log(result.steps);

const result = await client.resolve('llm-summarize', {
  text: 'Long document...',
}, { retries: 3 });
console.log(result.summary);

curl -X POST https://slopshop.gg/v1/pipes/content-machine \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"topic": "How AI agents use APIs", "keywords": "slopshop, automation"}'

curl -X POST https://slopshop.gg/v1/pipe \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"steps": [{"api": "crypto-hash-sha256"}, {"api": "text-base64-encode"}], "input": "hello"}'

curl https://slopshop.gg/v1/pipes

curl https://slopshop.gg/v1/agent/run \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "What tech stack does stripe.com use?"}'

curl https://slopshop.gg/v1/ask \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question": "Hash the word slopshop with SHA256"}'

# List available templates
curl https://slopshop.gg/v1/agent/templates

# Run a template
curl https://slopshop.gg/v1/agent/template/security-audit \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

curl https://slopshop.gg/v1/agent/history \
  -H "Authorization: Bearer YOUR_KEY"

# Create a compute-only key with a 100-credit cap
curl -X POST https://slopshop.gg/v1/auth/create-scoped-key \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"scope": "compute", "credit_cap": 100}'

# List all your keys
curl https://slopshop.gg/v1/auth/keys \
  -H "Authorization: Bearer sk-slop-your-key-here"

# Revoke a key
curl -X DELETE https://slopshop.gg/v1/auth/keys/sk-slop-scoped-key \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl -X POST https://slopshop.gg/v1/exec-python \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"code": "import math\nprint(math.factorial(10))"}'

curl -X POST https://slopshop.gg/v1/memory-vector-search \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "my-agent", "query": "authentication errors"}'

# Upload a file (base64-encoded content)
curl -X POST https://slopshop.gg/v1/files/upload \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"filename": "report.txt", "content": "SGVsbG8gd29ybGQ="}'

# Download a file
curl https://slopshop.gg/v1/files/{id} \
  -H "Authorization: Bearer sk-slop-your-key-here"

# List all files
curl https://slopshop.gg/v1/files \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl -X POST https://slopshop.gg/v1/agent/run \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"task": "Analyze slopshop.gg SSL and DNS", "stream": true}'

# Emits SSE events:
# event: planning  data: {"tools":["net-ssl-check","net-dns-lookup"]}
# event: step      data: {"tool":"net-ssl-check","result":{...}}
# event: complete  data: {"answer":"...","total_credits":12}

curl -X POST https://slopshop.gg/v1/llm-blog-draft \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"topic": "AI agents", "preview": true}'

# Response (no execution, no credit charge):
# {"preview": true, "estimated_credits": 20, "estimated_usd": 0.02, "can_afford": true}

# Store something (FREE)
curl https://slopshop.gg/v1/memory-set \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "my-agent", "key": "last-run", "value": "analyzed stripe.com", "tags": "audit,web"}'

# Retrieve it later (FREE)
curl https://slopshop.gg/v1/memory-get \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "my-agent", "key": "last-run"}'

# Search across all memories (FREE)
curl https://slopshop.gg/v1/memory-search \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "my-agent", "tag": "audit"}'

curl -X POST https://slopshop.gg/v1/chain/create \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"name":"research-loop","loop":true,"steps":[{"agent":"claude","prompt":"Research AI news"},{"agent":"grok","prompt":"Critique and improve"}]}'

curl -X POST https://slopshop.gg/v1/chain/advance \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"chain_id":"CHAIN_ID","context":{"previous_output":"AI news summary from step 1"}}'

curl https://slopshop.gg/v1/chain/status/CHAIN_ID \
  -H "Authorization: Bearer sk-slop-your-key-here"

# Pause a running chain
curl -X POST https://slopshop.gg/v1/chain/pause/CHAIN_ID \
  -H "Authorization: Bearer sk-slop-your-key-here"

# Resume a paused chain
curl -X POST https://slopshop.gg/v1/chain/resume/CHAIN_ID \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl https://slopshop.gg/v1/chain/list \
  -H "Authorization: Bearer sk-slop-your-key-here"

chain = client.chain_create(
    name="research-loop",
    loop=True,
    steps=[
        {"agent": "claude", "prompt": "Research AI news"},
        {"agent": "grok", "prompt": "Critique and improve"},
    ]
)
print(chain["chain_id"])

# Advance step
result = client.chain_advance(chain_id=chain["chain_id"], context={"data": "step 1 output"})

# Pause / resume
client.chain_pause(chain_id=chain["chain_id"])
client.chain_resume(chain_id=chain["chain_id"])

curl -X POST https://slopshop.gg/v1/chain/queue \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"prompts":[{"prompt":"Analyze competitors","agent":"claude"},{"prompt":"Summarize findings","agent":"grok"}],"frequency":"daily","schedule":"2026-03-28T09:00:00Z"}'

curl -X POST https://slopshop.gg/v1/chain/queue \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"prompts":[{"prompt":"Generate weekly analytics report","agent":"claude"}],"frequency":"once","schedule":"2026-03-28T03:00:00Z"}'

const job = await client.chainQueue({
  prompts: [
    { prompt: 'Analyze competitors', agent: 'claude' },
    { prompt: 'Summarize findings', agent: 'grok' },
  ],
  frequency: 'daily',
  schedule: '2026-03-28T09:00:00Z',
});
console.log(job.queue_id);

curl -X POST https://slopshop.gg/v1/templates/publish \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"name":"SEO Content Pipeline","description":"Generate SEO-optimized blog posts with keyword research","steps":[{"api":"llm-blog-outline","input":{"topic":"{{topic}}"}},{"api":"llm-blog-draft"},{"api":"text-readability-score"}],"tags":["seo","content","blog"]}'

# Browse all templates
curl https://slopshop.gg/v1/templates/browse \
  -H "Authorization: Bearer sk-slop-your-key-here"

# Filter by tag
curl "https://slopshop.gg/v1/templates/browse?tag=security" \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl -X POST https://slopshop.gg/v1/templates/fork/TEMPLATE_ID \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Custom SEO Pipeline"}'

curl -X POST https://slopshop.gg/v1/templates/rate/TEMPLATE_ID \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"rating":5,"review":"Excellent pipeline, saved me hours of setup"}'

# Publish
tmpl = client.templates_publish(name="SEO Pipeline", steps=[...], tags=["seo"])

# Browse
templates = client.templates_browse(tag="security")

# Fork
forked = client.templates_fork(template_id="TMPL_ID", name="My Version")

# Rate
client.templates_rate(template_id="TMPL_ID", rating=5)

curl -X POST https://slopshop.gg/v1/eval/run \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-research-agent","test_cases":[{"input":"Summarize quantum computing","expected_keywords":["qubit","superposition","entanglement"]},{"input":"Explain RSA encryption","expected_keywords":["prime","modular","public key"]}]}'

curl -X POST https://slopshop.gg/v1/eval/compare \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"agent_a":"research-v1","agent_b":"research-v2","test_cases":[{"input":"What is CRISPR?"}]}'

curl https://slopshop.gg/v1/eval/leaderboard \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl https://slopshop.gg/v1/eval/report/EVAL_ID \
  -H "Authorization: Bearer sk-slop-your-key-here"

const evalResult = await client.evalRun({
  agent_id: 'my-agent',
  test_cases: [
    { input: 'Summarize quantum computing', expected_keywords: ['qubit'] },
  ],
});
console.log(evalResult.score);

const comparison = await client.evalCompare({
  agent_a: 'v1', agent_b: 'v2',
  test_cases: [{ input: 'What is CRISPR?' }],
});
console.log(comparison.winner);

curl -X POST https://slopshop.gg/v1/replay/save \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"run_id":"RUN_ID","name":"Q1 research swarm","tags":["research","quarterly"]}'

curl https://slopshop.gg/v1/replay/REPLAY_ID \
  -H "Authorization: Bearer sk-slop-your-key-here"

# Save a replay
replay = client.replay_save(run_id="RUN_ID", name="Q1 research swarm")

# Retrieve replay
data = client.replay_get(replay_id=replay["replay_id"])
for step in data["steps"]:
    print(f"{step['agent']}: {step['action']}")

curl https://slopshop.gg/v1/credits/balance \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl -X POST https://slopshop.gg/v1/credits/buy \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"amount":1000}'

curl https://slopshop.gg/v1/analytics/usage \
  -H "Authorization: Bearer sk-slop-your-key-here"

// Check balance
const balance = await client.creditsBalance();

// Buy credits
await client.creditsBuy({ amount: 1000 });

// View usage
const usage = await client.analyticsUsage();

curl -X POST https://slopshop.gg/v1/reputation/vote \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"research-bot-v2","vote":"up","reason":"Consistently high-quality research output"}'

curl https://slopshop.gg/v1/reputation/leaderboard \
  -H "Authorization: Bearer sk-slop-your-key-here"

// Upvote an agent
await client.reputationVote({ agent_id: 'research-bot-v2', vote: 'up' });

// View leaderboard
const leaders = await client.reputationLeaderboard();
leaders.forEach(a => console.log(`${a.agent_id}: ${a.score}`));

# Step 1: Run locally (e.g., hash a file)
LOCAL_HASH=$(sha256sum myfile.txt | cut -d' ' -f1)

# Step 2: Enhance with cloud tools
curl -X POST https://slopshop.gg/v1/agent/run \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d "{\"task\":\"I computed SHA256 hash $LOCAL_HASH for myfile.txt. Verify this is a valid SHA256 format and store in memory for audit trail.\",\"store_result\":true}"

import hashlib
from slopshop import Slop

# Local computation (free, instant)
with open("data.csv", "r") as f:
    content = f.read()
local_hash = hashlib.sha256(content.encode()).hexdigest()

# Cloud enhancement (Slopshop)
client = Slop()
result = client.call("llm-summarize", text=content[:5000])
client.call("memory-set", namespace="audit", key=f"file-{local_hash}", value=result["summary"])

https://slopshop.gg/visualizer

# Start the MCP server (default port 3001)
slop mcp serve

# Or with a custom port
slop mcp serve --port 8484

# Browse available recipes
ls integrations/goose-recipes/

# Example: security audit recipe
goose run integrations/goose-recipes/security-audit.yaml

custom-commands:
  slop-hash:
    command: slop call crypto-hash-sha256 --data "$input"
    description: Hash a string with SHA-256
  slop-resolve:
    command: slop call resolve --data '{"query": "$input"}'
    description: Find the right Slopshop tool for a task

# Install the plugin
opencode plugin add slopshop

# Tools are now available in OpenCode sessions
opencode > /tools  # lists all Slopshop tools

{
  "mcpServers": {
    "slopshop": {
      "command": "slop",
      "args": ["mcp", "serve"],
      "env": { "SLOPSHOP_KEY": "sk-slop-your-key-here" }
    }
  }
}

from langchain.tools import Tool
import requests, os

BASE = "https://slopshop.gg/v1"
KEY = os.environ["SLOPSHOP_KEY"]
headers = {"Authorization": f"Bearer {KEY}"}

# Fetch all tools in OpenAI format
openai_tools = requests.get(f"{BASE}/tools?format=openai", headers=headers).json()["tools"]

# Convert to LangChain tools
def call(slug, **kw):
    return requests.post(f"{BASE}/{slug}", headers=headers, json=kw).json()["data"]

lc_tools = [
    Tool(name=t["function"]["name"], description=t["function"]["description"],
         func=lambda x, s=t["function"]["name"]: call(s, input=x))
    for t in openai_tools
]

# Use with LangGraph
from langgraph.prebuilt import create_react_agent
agent = create_react_agent(model, lc_tools)

# Scaffold a full-stack project
slop init --full-stack my-agent-app

# Minimal API-only scaffold
slop init my-tool-script

# Start a local agent pool (default: 4 workers)
slop agents

# Custom pool size
slop agents --workers 8

# With a task file
slop agents --tasks tasks.json

# Stream live swarm events
curl -N https://slopshop.gg/v1/visualizer/stream \
  -H "Authorization: Bearer $KEY"

# Returns SSE events: agent_spawn, task_complete, merkle_update, hive_message

# Bootstrap MCP for Claude Desktop (auto-configures claude_desktop_config.json)
slop mcp bootstrap --ide=claude-desktop

# Bootstrap for Cursor
slop mcp bootstrap --ide=cursor

# Query the memory graph
curl -X POST https://slopshop.gg/v1/memory/graph-query \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "agent orchestration", "depth": 3, "vector_boost": true}'

curl -X POST https://slopshop.gg/v1/memory/auto-summarize \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "research-swarm-42", "max_tokens": 500}'

# Snapshot a namespace
curl -X POST https://slopshop.gg/v1/memory/snapshot \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "research-swarm-42", "pin": true}'

# List snapshots
curl https://slopshop.gg/v1/memory/snapshots \
  -H "Authorization: Bearer $KEY"

curl -X POST https://slopshop.gg/v1/memory/evolve/start \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "research", "strategy": "consolidate", "budget_per_cycle": 5, "interval_minutes": 10}'

GET  /v1/memory/evolve/status    — Check active evolutions
GET  /v1/memory/evolve/log       — View evolution history
POST /v1/memory/evolve/stop      — Stop an active evolution by ID

curl -X POST https://slopshop.gg/v1/memory/decay \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "research", "factor": 0.95}'

curl -X POST https://slopshop.gg/v1/chain/run/branching \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chain_id": "your-chain-id",
    "max_steps": 10,
    "max_iterations": 100
  }'

{
  "steps": [
    { "prompt": "Analyze the data", "agent": "claude" },
    { "condition": "step_0_result.confidence > 0.8", "prompt": "Deep dive", "agent": "grok" },
    { "condition": "step_0_result.confidence <= 0.8", "prompt": "Gather more data", "agent": "claude", "else_step": 0 }
  ]
}

curl -X POST https://slopshop.gg/v1/grok/optimize \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Deploy 1k army for text analysis", "optimize_for": "cost"}'

curl -X POST https://slopshop.gg/v1/grok/critique \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Research report on agent infrastructure...", "depth": "thorough"}'

curl -X POST https://slopshop.gg/v1/grok/overlord \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"goal": "Deep tech audit on Stripe", "budget_credits": 500, "models": ["claude", "gpt", "deepseek"]}'

curl -X POST https://slopshop.gg/v1/sandbox/execute \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "return 2 + 2", "timeout_ms": 5000}'

1. POST /v1/eval/run          — Run evaluations to score agent performance
2. POST /v1/reputation/slash   — Slash underperforming agents
3. GET  /v1/reputation/ledger  — View the global reputation leaderboard

curl -X POST https://slopshop.gg/v1/chaos/test \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"army_id": "EXT-47", "faults": ["network", "latency", "agent-drop"]}'

# Issue identity token
curl -X POST https://slopshop.gg/v1/identity/issue \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"research-bot","name":"Research Bot","capabilities":["llm","tools"]}'

# Register in Agent Name Service
curl -X POST https://slopshop.gg/v1/ans/register \
  -H "Authorization: Bearer $KEY" \
  -d '{"name":"research-bot","agent_id":"research-bot","endpoint":"https://myapp.com/agent","capabilities":["research","memory"]}'

# Submit reputation signal
curl -X POST https://slopshop.gg/v1/reputation/signal \
  -H "Authorization: Bearer $KEY" \
  -d '{"agent_id":"research-bot","signal":"success","task":"daily-research"}'

# Start a session
curl -X POST https://slopshop.gg/v1/computer-use/session/start \
  -H "Authorization: Bearer $KEY" \
  -d '{"name":"organize-downloads","task":"Batch resize images and organize by date"}'

# Log a screenshot + run OCR
curl -X POST https://slopshop.gg/v1/computer-use/screenshot \
  -H "Authorization: Bearer $KEY" \
  -d '{"session_id":"SESSION_ID","image_base64":"...","label":"before-resize"}'

# Export replay as Python (pyautogui)
curl -X POST https://slopshop.gg/v1/computer-use/replay \
  -H "Authorization: Bearer $KEY" \
  -d '{"session_id":"SESSION_ID","format":"python"}'

# Get signed MCP manifest
curl https://slopshop.gg/v1/gateway/manifest \
  -H "Authorization: Bearer $KEY"

# Create a policy
curl -X POST https://slopshop.gg/v1/policy/create \
  -H "Authorization: Bearer $KEY" \
  -d '{"name":"block-heavy","rules":[{"condition":"credit_over","value":500,"action":"require_approval"}]}'

# Export audit log (ECS NDJSON)
curl -X POST https://slopshop.gg/v1/gateway/audit/export \
  -H "Authorization: Bearer $KEY" \
  -d '{"format":"ecs","limit":1000}'

# Get full dashboard
curl https://slopshop.gg/v1/observe/dashboard \
  -H "Authorization: Bearer $KEY"

# Set credit budget
curl -X POST https://slopshop.gg/v1/observe/budget/set \
  -H "Authorization: Bearer $KEY" \
  -d '{"budget_credits":10000,"alert_threshold":0.8}'

# Record ROI event
curl -X POST https://slopshop.gg/v1/observe/roi/record \
  -H "Authorization: Bearer $KEY" \
  -d '{"event_type":"pr_merged","value_usd":50,"tool_slug":"devops-semver-bump"}'

# List templates
curl https://slopshop.gg/v1/workflow/templates \
  -H "Authorization: Bearer $KEY"

# Create a workflow
curl -X POST https://slopshop.gg/v1/workflow/create \
  -H "Authorization: Bearer $KEY" \
  -d '{"name":"hash-and-store","nodes":[{"id":"n1","type":"tool","slug":"crypto-hash-sha256"},{"id":"n2","type":"tool","slug":"memory-set"}],"edges":[{"from":"n1","to":"n2","output":"hash"}]}'

# Run standard benchmark
curl -X POST https://slopshop.gg/v1/eval/benchmark \
  -H "Authorization: Bearer $KEY"
# → {"score":100,"grade":"A","passed":5,"failed":0}

# Browse templates
curl https://slopshop.gg/v1/marketplace/templates \
  -H "Authorization: Bearer $KEY"

# Invoke a template
curl -X POST https://slopshop.gg/v1/marketplace/invoke \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug": "research-swarm", "params": {"topic": "AI infrastructure"}}'

# Build and publish a plugin
slop forge build --name="custom-analyzer" --publish=marketplace

# Install a plugin from marketplace
slop forge install custom-analyzer

curl -X POST https://slopshop.gg/v1/research \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Compare agent infrastructure platforms 2026", "tier": "planet", "provider": "all", "namespace": "my-research"}'

curl -X POST https://slopshop.gg/v1/memory/upload \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "# My Project\n\n## Goals\nBuild the best agent backend...", "namespace": "my-project", "filename": "project-notes.md"}'

curl -X POST https://slopshop.gg/v1/memory/share/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "team-research",
    "retention": "weekly",
    "description": "Shared research context for product team"
  }'

# Returns: {"space_id": "space_abc123", "namespace": "team-research", "retention": "weekly", "expires_at": "2026-04-30T00:00:00Z"}

curl -X POST https://slopshop.gg/v1/memory/collaborator/invite \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "team-research", "invitee_key": "sk_other_agent", "permissions": "read-write"}'

# permissions: "read" | "read-write" | "admin"

curl -X POST https://slopshop.gg/v1/memory/collaborator/accept \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"invite_id": "INV-abc123"}'

# List collaborators on a namespace
curl https://slopshop.gg/v1/memory/collaborator/list \
  -H "Authorization: Bearer $KEY" \
  -G -d "namespace=team-research"

# Revoke access
curl -X POST https://slopshop.gg/v1/memory/collaborator/revoke \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "team-research", "collaborator_key": "sk_other_agent"}'

# Write (any collaborator with write permission)
curl -X POST https://slopshop.gg/v1/memory-set \
  -H "Authorization: Bearer $OTHER_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "latest_findings", "value": "...", "namespace": "team-research"}'

# Read (any collaborator)
curl -X POST https://slopshop.gg/v1/memory-get \
  -H "Authorization: Bearer $MY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "latest_findings", "namespace": "team-research"}'

curl -X POST https://slopshop.gg/v1/memory/evolve/start \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "my-research", "tier": "advanced"}'

curl -X POST https://slopshop.gg/v1/memory/dream/start \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace": "my-agent",
    "strategy": "insight_generate",
    "adversarial": true,
    "salience_threshold": 0.4
  }'

# Returns: {"run_id": "dream_run_abc123", "status": "started", "strategy": "insight_generate"}

GET /v1/memory/dream/status/:run_id
Authorization: Bearer $KEY

# Returns: {"run_id": "...", "status": "complete", "memories_processed": 142, "insights_generated": 7}

curl -X POST https://slopshop.gg/v1/memory/dream/schedule \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace": "my-agent",
    "cron": "0 2 * * *",
    "strategy": "insight_generate",
    "adversarial": true,
    "salience_threshold": 0.3,
    "active": true
  }'

# cron field accepts standard 5-part cron expressions
# active: true/false — pause/resume without deleting
# Returns: {"schedule_id": "sched_xyz", "next_run": "2026-04-02T02:00:00Z"}

GET    /v1/memory/dream/schedules          — List all schedules for your key
GET    /v1/memory/dream/schedules/:id      — Get a single schedule
PATCH  /v1/memory/dream/schedules/:id      — Update cron, strategy, or active status
DELETE /v1/memory/dream/schedules/:id      — Remove a schedule

POST   /v1/dream/subscribe      — Subscribe to a research topic on a schedule
GET    /v1/dream/insights        — List generated insights
POST   /v1/dream/run             — Trigger immediate topic research
POST   /v1/dream/deploy          — Deploy insight into agent memory
POST   /v1/dream/dismiss         — Dismiss insight
GET    /v1/dream/subscriptions   — List subscriptions

curl https://slopshop.gg/v1/memory/dream/report/dream_run_abc123 \
  -H "Authorization: Bearer $KEY"

# Returns:
{
  "dream_id": "dream_run_abc123",
  "namespace": "my-agent",
  "strategy": "forecast",
  "status": "complete",
  "duration_sec": 45,
  "memories_processed": 142,
  "insights_generated": 12,
  "procedural_skills_extracted": 3,
  "intelligence_score": 53.3,
  "dream_efficiency_score": 63.3,
  "entries": [...],
  "meta": {
    "model": "claude-3-5-sonnet",
    "adversarial": false,
    "salience_threshold": 0.0,
    "credits_used": 35
  }
}

curl -X POST https://slopshop.gg/v1/memory/tmr/queue \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace": "my-agent",
    "target_keys": ["project-brief", "competitor-analysis", "q1-goals"],
    "priority": 8,
    "mode": "consolidate",
    "personalization": "Focus on strategic risks and opportunity gaps"
  }'

# Returns:
{
  "cue_id": "tmr_cue_xyz789",
  "queued_keys": 3,
  "combined_reactivation_prompt": "Before this session, recall: [project-brief]... [competitor-analysis]... [q1-goals]... Focus on strategic risks and opportunity gaps.",
  "expires_at": "2026-04-02T02:00:00Z"
}

curl "https://slopshop.gg/v1/memory/tmr/cues?namespace=my-agent&limit=10&mode=consolidate" \
  -H "Authorization: Bearer $KEY"

# Returns:
{
  "cues": [
    {
      "cue_id": "tmr_cue_xyz789",
      "target_keys": ["project-brief", "competitor-analysis", "q1-goals"],
      "priority": 8,
      "mode": "consolidate",
      "created_at": "2026-04-01T22:00:00Z"
    }
  ],
  "combined_reactivation_prompt": "Before this session, recall: [project-brief summary]... [competitor-analysis summary]... [q1-goals summary]...",
  "total": 1
}

curl -X POST https://slopshop.gg/v1/memory/dream/collective \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "space_id": "space_team_abc123",
    "strategy": "synthesize",
    "budget": 500,
    "model": "claude"
  }'

# Returns:
{
  "dream_id": "collective_dream_xyz",
  "space_id": "space_team_abc123",
  "status": "started",
  "poll_endpoint": "/v1/memory/dream/status/collective_dream_xyz",
  "report_endpoint": "/v1/memory/dream/report/collective_dream_xyz"
}

curl "https://slopshop.gg/v1/memory/skills?namespace=my-agent&min_confidence=0.7&strategy=reflect&limit=20" \
  -H "Authorization: Bearer $KEY"

# Returns:
{
  "skills": [
    {
      "skill_id": "skill_abc123",
      "name": "competitive-intelligence-loop",
      "description": "Search competitors, extract signals, synthesize into structured report",
      "tool_chain": ["search-web", "extract-text", "llm-think", "memory-set"],
      "confidence": 0.91,
      "applications": 14,
      "extracted_by": "reflect",
      "dream_id": "dream_run_abc123",
      "created_at": "2026-04-01T03:00:00Z"
    }
  ],
  "total": 1,
  "namespace": "my-agent"
}

curl -X POST https://slopshop.gg/v1/memory/branch \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{"namespace": "my-project", "label": "before-experiment-7"}'

# Returns: snapshot_id, merkle_root, key_count

curl -X POST https://slopshop.gg/v1/memory/restore/mbranch-abc123 \
  -H "Authorization: Bearer $SLOP_KEY"

curl -X POST https://slopshop.gg/v1/memory/merge \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{"source_id": "mbranch-aaa", "target_id": "mbranch-bbb", "policy": "auto"}'

# policy: auto | llm-smart | human-in-loop | agent-debate

POST   /v1/memory/branch                — Create Merkle-rooted branch snapshot
POST   /v1/memory/restore/:id           — Restore namespace from branch
GET    /v1/memory/branches              — List all branches
POST   /v1/memory/branch/compare        — Diff two branches
POST   /v1/memory/merge                 — Merge two branches
GET    /v1/memory/conflicts/:merge_id   — View unresolved merge conflicts
POST   /v1/memory/conflicts/:merge_id/resolve — Resolve conflicts manually

curl -X POST https://slopshop.gg/v1/memory/bayesian/update \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{
    "key": "user_will_churn",
    "prior": 0.2,
    "likelihood": 0.8,
    "evidence": "user_opened_cancellation_page",
    "namespace": "crm"
  }'

# Returns: { prior: 0.2, likelihood: 0.8, posterior: 0.667, confidence_delta: 0.467 }

# Add an episode
curl -X POST https://slopshop.gg/v1/memory/episode \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{"content": "User rejected proposal B", "episode_type": "decision", "prev_id": "ep-xyz123"}'

# Traverse the chain
GET /v1/memory/chain?namespace=project&start=ep-abc&direction=forward&limit=20

curl -X POST https://slopshop.gg/v1/memory/trigger \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{
    "condition_type": "key_count_exceeds",
    "condition_value": "100",
    "action_type": "dream",
    "action_config": {"strategy": "compress"},
    "namespace": "research"
  }'

POST   /v1/memory/trigger        — Register memory-condition trigger
GET    /v1/memory/triggers       — List all triggers
DELETE /v1/memory/trigger/:id    — Remove a trigger

curl -X POST https://slopshop.gg/v1/memory/procedure/learn \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{
    "name": "competitive-analysis",
    "description": "Research competitors, extract signals, synthesize report",
    "tool_chain": ["search-web", "extract-text", "llm-think", "memory-set"],
    "trigger_pattern": "analyze competitors"
  }'

curl -X POST https://slopshop.gg/v1/swarm/orchestrate \
  -H "Authorization: Bearer $SLOP_KEY" \
  -d '{
    "task": "Research the current state of multi-agent AI frameworks",
    "agents": [
      {"role": "researcher", "prompt": "Find and summarize recent developments"},
      {"role": "analyst", "prompt": "Extract key trends and gaps"},
      {"role": "synthesizer", "prompt": "Write an actionable executive summary"}
    ],
    "namespace": "research",
    "dream_after": true
  }'

POST   /v1/swarm/orchestrate     — Run structured orchestration with 6-axis scoring
POST   /v1/swarm/create          — Create a persistent swarm configuration
GET    /v1/swarm/:id/status      — Check swarm status
GET    /v1/swarms                — List all swarms

# Single provider
curl -X POST https://slopshop.gg/v1/research \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest MCP agent frameworks 2026", "tier": "advanced", "provider": "claude"}'

# Planet tier — all providers, cross-synthesized
curl -X POST https://slopshop.gg/v1/research \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI infrastructure trends 2026",
    "tier": "planet",
    "provider": "all",
    "namespace": "my-research"
  }'

# Results are cached 30 minutes per query+tier+provider combination
# Results are automatically stored in memory namespace 'research' (or custom namespace)

{
  "query": "AI infrastructure trends 2026",
  "tier": "planet",
  "provider": "all",
  "findings": { ... },       // structured findings per provider
  "synthesis": "...",        // cross-provider synthesis (deep/planet only)
  "sources": [...],
  "confidence": 0.92,
  "cached": false,
  "memory_key": "research_a1b2c3",
  "_engine": "real"
}

GET /v1/research/history?limit=20
Authorization: Bearer $KEY

# Returns stored research results from memory namespace 'research'

# Set state
curl -X POST https://slopshop.gg/v1/state/my-counter \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"value": 0}'

# Get state
GET /v1/state/my-counter

GET /v1/state
Authorization: Bearer $KEY

# Returns all state key-value pairs for your API key

curl -X POST https://slopshop.gg/v1/state/page-views/increment \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"by": 1}'

# by is optional, defaults to 1
# Returns: {"key": "page-views", "value": 42, "previous": 41}

curl -X POST https://slopshop.gg/v1/files/upload \
  -H "Authorization: Bearer $KEY" \
  -F "file=@report.pdf"

GET /v1/files                    — List all files
GET /v1/files?search=report      — Search by filename
GET /v1/files?tag=research       — Filter by tag
GET /v1/files/search?q=report    — Full-text search endpoint

# Delete
DELETE /v1/files/:id

# Rename
POST /v1/files/:id/rename
{"filename": "new-report.pdf"}

# Copy
POST /v1/files/:id/copy
{"filename": "report-copy.pdf"}   # optional new filename

curl -X POST https://slopshop.gg/v1/schedules \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily report",
    "cron": "0 9 * * *",
    "task": "crypto-hash-sha256",
    "input": {"data": "daily-seed"}
  }'

GET /v1/schedules/:id
Authorization: Bearer $KEY

GET /v1/schedules/:id/history?limit=50
Authorization: Bearer $KEY

# Returns: [{ran_at, status, credits_used, error}, ...]

POST /v1/schedules/:id/pause    — Disable schedule (sets enabled=false)
POST /v1/schedules/:id/resume   — Re-enable schedule
POST /v1/schedules/:id/trigger  — Run immediately (sets next_run to now)

slop template run research-swarm \
  --topic="AI agent infrastructure 2026" \
  --loops=10 \
  --budget=200

curl -X POST https://slopshop.gg/v1/templates/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-pipeline", "steps": [
    {"tool": "sense-url-content", "params": {"url": "$input_url"}},
    {"tool": "text-summarize", "params": {"text": "$prev.content"}},
    {"tool": "memory-set", "params": {"key": "summary_$input_url", "value": "$prev.summary"}}
  ]}'

curl -X POST https://slopshop.gg/v1/connectors/config \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"toolkit":"github","client_id":"YOUR_GITHUB_APP_ID","client_secret":"YOUR_SECRET","scopes":["repo"],"auth_url":"https://github.com/login/oauth/authorize","token_url":"https://github.com/login/oauth/access_token"}'

GET  /v1/connectors/list              — List all configured connectors
GET  /v1/connectors/connect/:toolkit  — Start OAuth flow for a toolkit (returns redirect URL)
DELETE /v1/connectors/:id             — Remove a connector and revoke tokens

curl -X POST https://slopshop.gg/v1/triggers/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"on-push","source":"github","event":"push","action":{"chain_id":"deploy-pipeline"}}'

POST /v1/triggers/webhook/:id  — Webhook receiver (give this URL to external services)
GET  /v1/triggers/list          — List all configured triggers

curl https://slopshop.gg/v1/audit/export \
  -H "Authorization: Bearer $KEY"

curl -X POST https://slopshop.gg/v1/import/schemas \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"schemas":[{"slug":"custom-tool","name":"Custom Tool","description":"My custom handler","input":{"type":"object","properties":{"text":{"type":"string"}}},"output":{"type":"object","properties":{"result":{"type":"string"}}}}]}'

git clone https://github.com/slopshop/slopshop.git
cd slopshop
npm install
node server-v2.js

docker build -t slopshop .
docker run -p 3000:3000 \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -e OPENAI_API_KEY=sk-... \
  slopshop

curl -X POST https://slopshop.gg/v1/northstar/set \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"goal": "building an open-source AI messaging platform"}'

curl https://slopshop.gg/v1/northstar \
  -H "Authorization: Bearer sk-slop-your-key-here"

curl -X POST https://slopshop.gg/v1/hive/daily-intelligence \
  -H "Authorization: Bearer sk-slop-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"mode": "medium", "hive_id": "optional-hive-id"}'