PYRESEC AI Code Security Auditing README | AllMCPs

PYRESEC — AI Code Security Engine

Autonomous SAST/SCA security auditing via x402 USDC micropayments on Base. No subscriptions. No accounts. Just code in, findings out.

Live Instance

Endpoint	URL
Landing	pyresec-agent-519576377065.us-central1.run.app
Swagger UI	/swagger
Health	/health
MCP Manifest	/mcp/manifest.json
OpenAPI Spec	/openapi.json

Quick Start

Option 1: x402 Python Client (Recommended)

Terminal

pip install x402

Dockerfile

import x402

client = x402.Client(wallet_key="your-base-private-key")
response = client.post(
    "https://pyresec-agent-519576377065.us-central1.run.app/v1/audit/quick-scan",
    json={"code": "def login(u,p): return db.query(f\"SELECT * FROM users WHERE name={u} AND pass={p}\")"}
)
print(response.json())

Option 2: curl (Manual x402 Flow)

Dockerfile

# Step 1: Send request (returns 402 with payment requirements)
curl -X POST https://pyresec-agent-519576377065.us-central1.run.app/v1/audit/quick-scan \
  -H "Content-Type: application/json" \
  -d '{"code": "def login(u,p): return db.query(f\"SELECT * FROM users WHERE name={u} AND pass={p}\")"}'

# Step 2: Pay $0.01 USDC on Base using x402 protocol

# Step 3: Resubmit with X-PAYMENT header
curl -X POST https://pyresec-agent-519576377065.us-central1.run.app/v1/audit/quick-scan \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <payment-proof>" \
  -d '{"code": "..."}'

Option 3: GitHub Action (CI/CD)

yaml

- name: PYRESEC Security Scan
  uses: nanoclone-ltd/pyresec-scan-action@main
  with:
    code-path: ./src
    tier: quick-scan
    x402-wallet-key: ${{ secrets.X402_WALLET_KEY }}

Option 4: MCP-Compatible Agent (Claude, Cursor, etc.)

PYRESEC is a registered MCP tool. Any MCP-compatible client discovers it automatically:

config.json

{
  "mcpServers": {
    "pyresec": {
      "url": "https://pyresec-agent-519576377065.us-central1.run.app/mcp"
    }
  }
}

Service Tiers

Tier	Price	Endpoint	Description	Model
Quick Scan	$0.01	`POST /v1/audit/quick-scan`	Top 3 findings by severity, CWE IDs, line numbers	qwen3.6-27b
Deep Audit	$0.50	`POST /v1/audit/deep-repo`	OWASP Top 10, SCA dependency scanning, logic flaws, gas optimization	qwen3.8-27b
Remediation	$5.00	`POST /v1/audit/remediate`	Full patched code with change explanations and security notes	qwen3.8-27b

x402 Payment Flow

PYRESEC uses the x402 protocol for permissionless micropayments on Base. No accounts, no API keys, no subscriptions.

Code

┌──────────┐     POST /v1/audit/quick-scan     ┌──────────┐
│  Client   │ ───────────────────────────────▶  │  PYRESEC │
│ (x402)    │ ◀──── 402 Payment Required ─────  │  Agent   │
│           │       { amount, network, to }     │          │
│           │                                   │          │
│           │ ──── X-PAYMENT (proof) ─────────▶ │          │
│           │ ◀──── 200 + Scan Results ──────── │          │
└──────────┘                                   └──────────┘

How it works:

Client sends a POST request to any audit endpoint
PYRESEC returns 402 Payment Required with payment details (amount, recipient address, network)
Client signs and submits a USDC transfer on Base mainnet
Client resubmits the original request with the X-PAYMENT header containing the payment proof
PYRESEC verifies the payment on-chain and returns the scan results

No wallet? Use the x402 Python SDK or any x402-compatible client.

Architecture

Code

                         ┌─────────────────────────────────┐
                         │          Client Layer            │
                         │  x402 SDK / curl / MCP Client    │
                         └──────────────┬──────────────────┘
                                        │
                              ┌─────────▼─────────┐
                              │   FastAPI Server   │
                              │   (Cloud Run)      │
                              │                    │
                              │  ┌──────────────┐  │
                              │  │ x402 Payment │  │
                              │  │  Middleware   │  │
                              │  └──────┬───────┘  │
                              └─────────┼──────────┘
                                        │
                    ┌───────────────────┼───────────────────┐
                    │                   │                   │
          ┌─────────▼─────────┐ ┌───────▼───────┐ ┌───────▼───────┐
          │  Agent Controller │ │  Population   │ │   Wallet      │
          │  (SAST + LLM)     │ │  Controller   │ │  Interface    │
          └─────────┬─────────┘ └───────────────┘ └───────────────┘
                    │
          ┌─────────▼─────────┐
          │   Groq LLM        │
          │   (qwen models)   │
          └─────────┬─────────┘
                    │
          ┌─────────▼─────────┐
          │  Security Findings │
          │  JSON Response     │
          └───────────────────┘

Supported Vulnerability Types

#	Type	CWE	Severity
1	SQL Injection	CWE-89	HIGH
2	Cross-Site Scripting (XSS)	CWE-79	HIGH
3	Command Injection	CWE-78	CRITICAL
4	Path Traversal	CWE-22	MEDIUM
5	Hardcoded Secrets	CWE-798	CRITICAL
6	Weak Cryptography	CWE-327	MEDIUM
7	SSRF	CWE-918	HIGH
8	Insecure Deserialization	CWE-502	HIGH
9	Authentication Bypass	CWE-287	CRITICAL
10	Improper Input Validation	CWE-20	MEDIUM

For AI Agents (MCP Integration)

PYRESEC is discoverable by any MCP-compatible agent. When an agent needs to audit code, it can find PYRESEC automatically through:

MCP Registry: registry.modelcontextprotocol.io
Smithery.ai: smithery.ai/server/@renaat-s/pyresec-agent
Direct manifest: /mcp/manifest.json

Tool Definitions

Tool	Description	Cost
`quick_scan`	Fast SAST scan, top 3 findings by severity with CWE IDs	$0.01 USDC
`deep_audit`	Full OWASP Top 10, SCA, logic flaws, gas optimization	$0.50 USDC
`remediate_code`	Auto-patched code with change explanations, ready for PR	$5.00 USDC

Agent Discovery Flow

Code

1. Agent queries MCP Registry for "security audit" tools
2. PYRESEC appears in results with tool schemas
3. Agent calls quick_scan with source code
4. PYRESEC returns 402 with x402 payment requirements
5. Agent's x402 wallet pays USDC on Base
6. Agent resubmits with payment proof
7. PYRESEC returns findings as structured JSON

Self-Sustaining Agent

PYRESEC runs as an autonomous agent on Base Mainnet:

Heartbeat every 30 min — checks balance, reports health
Death — shuts down if balance < $0.05
Replication — sends 50% surplus to dev wallet when balance > $20
Kill switch — admin can halt all instances remotely

Deployment

Docker

Terminal

docker build -t pyresec-agent .
docker run -p 8080:8080 --env-file .env pyresec-agent

Google Cloud Run

bash

gcloud run deploy pyresec-agent \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars "CDP_WALLET_SECRET=$CDP_WALLET_SECRET,GROQ_API_KEY=$GROQ_API_KEY"

Company

NanoClone Life Sciences Ltd. (UK) Website: nanoclonesystems.com

License

Proprietary. See LICENSE for details.