+-------------------+       1. MCP Tool Call       +------------------------+
|  AI Agent / LLM   | ---------------------------> |  contextslim           |
| (CrewAI/LangChain)| <--------------------------- |  (Python SDK Engine)   |
+-------------------+     4. Pruned Payload        +------------------------+
                                                               |        ^
                                             2. x402 Payment   |        | 3. Optimized Data
                                                Challenge/Pass |        |    & Reference ID
                                                               v        |
                                                   +--------------------------------+
                                                   | ContextSlim Worker Engine      |
                                                   | (Cloudflare KV + Pruner Engine)|
                                                   +--------------------------------+
                                                                   |
                                                                   v (On-Chain Settlement)
                                                   +--------------------------------+
                                                   | Base Network (USDC / ERC-3009) |
                                                   +--------------------------------+

pip install contextslim eth-account python-dotenv

{
  "mcpServers": {
    "contextslim": {
      "command": "uvx",
      "args": ["contextslim"],
      "env": {
        "ENDPOINT_URL": "https://contextslim.friczero.com",
        "PRIVATE_KEY": "0x_YOUR_AGENT_PRIVATE_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "contextslim": {
      "url": "https://contextslim.friczero.com/message"
    }
  }
}

npx -y @smithery/cli install contextslim --client claude

import os
from dotenv import load_dotenv
from eth_account import Account
from contextslim import ContextSlimClient

load_dotenv()

def main():
    # 1. Initialize Local Signer (Private key isolated in memory)
    signer = Account.from_key(os.getenv("PRIVATE_KEY"))

    # 2. Instantiate ContextSlim Client
    client = ContextSlimClient(
        endpoint=os.getenv("ENDPOINT_URL", "https://contextslim.friczero.com"),
        signer=signer,
        allowance_budget=0.005,  # Optional: Enables Session Pass to avoid signing every query
        max_token_budget=1000,
    )

    # 3. Prune Massive Payload (optimize_context)
    heavy_payload = {
        "company": "Acme Corp International",
        "key_team": [
            {"name": "Alice Gomez", "role": "CTO"},
            {"name": "Carlos M.", "role": "CEO"},
        ],
        "historical_logs": [f"Log entry #{i + 1}: Activity sweep" for i in range(100)],
    }

    print("Optimizing massive context...")
    prep = client.call_tool("optimize_context", {
      "data": heavy_payload,
      "maxTokenBudget": 150
    })

    res = prep.get("result", {})
    ref_id = res.get("toolResultReference", {}).get("referenceId") or res.get("referenceId")
    
    print(f"Reference Cached in KV: {ref_id}")
    print(f"Saved Tokens: {prep.get('metrics', {}).get('savedTokens')}")
    print(f"Compression Ratio: {prep.get('metrics', {}).get('reductionPercentage')}")

    # 4. Targeted Path Extraction (fetch_result)
    print("Retrieving only 'key_team[0].name'...")
    extracted = client.call_tool("fetch_result", {
      "referenceId": ref_id,
      "paths": ["company", "key_team[0].name"]
    })

    print("Result:", extracted.get("result"))
    # Returns only 23 tokens: {"company": "Acme Corp International", "key_team": [{"name": "Alice Gomez"}]}

if __name__ == "__main__":
    main()

from contextslim import ContextSlimClient
from my_kms_signer import AWSKMSSigner  # Custom wrapper around boto3 KMS sign_digest

kms_signer = AWSKMSSigner(key_id="arn:aws:kms:us-east-1:123456789012:key/your-agent-key-id")

client = ContextSlimClient(
    endpoint="https://contextslim.friczero.com",
    signer=kms_signer,
)

from contextslim import ContextSlimClient
from turnkey import TurnkeyAccount

turnkey_signer = TurnkeyAccount(
    organization_id=os.getenv("TURNKEY_ORGANIZATION_ID"),
    wallet_address=os.getenv("TURNKEY_WALLET_ADDRESS"),
)

client = ContextSlimClient(
    endpoint="https://contextslim.friczero.com",
    signer=turnkey_signer,
)

{
    "status": "success",
    "result": {
        "toolResultReference": {"referenceId": "ref_ef17a253", "expiresIn": "3600s"},
        # ... pruned payload
    },
    "metrics": {
        "savedTokens": "406",
        "reductionPercentage": "74.8%",
        "strategy": "recursive:arrays(47_items)",
    },
}

{
    "status": "success",
    "referenceId": "ref_ef17a253",
    "retrievedTokens": 23,
    "result": {
        "company": "Acme Corp International",
        "key_team": [{"name": "Alice Gomez"}],
    },
}