Ruff Lint X402

io.github.Divine-Software-CreationsPublished by GitHub account Divine-Software-Creationsv1.0.0Updated Nov 5, 2026

Ruff Python linting for AI agents, pay-per-call via x402 ($0.005 USDC on Base).

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

Local MCP server that lets an assistant lint Python code with ruff, paying $0.005 USDC per call over x402 on Base.

What you can do
  • Lint Python code: send a code string (up to 200KB) with an optional filename and get ruff diagnostics with rule code, message, line/column and fix hints.
  • Pay per call: each request is settled automatically over x402 in USDC on Base, with no signup, API key or subscription.
When to use it
Useful when an assistant needs quick Python style or correctness checks while writing or reviewing code, and you are comfortable paying a small per-call fee in USDC from a Base wallet instead of running ruff locally.
Requirements
Runs as a local stdio process, typically launched with npx from the npm package, so Node.js is needed. Requires the EVM_PRIVATE_KEY environment variable holding the private key of a Base wallet with USDC. Network access to the remote lint API is needed for each call.
Before you install
The server asks for a wallet private key in EVM_PRIVATE_KEY, which grants control of that wallet's funds; the README advises a dedicated low-balance wallet. Every call spends USDC ($1 covers about 200 calls). Submitted code is sent to a third-party API for analysis, so avoid sending sensitive source.

Installation

In SourceWeft

  1. Open Ruff Lint X402 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Ruff Python Lint API — pay-per-call for AI agents (MCP + x402)

[npm]

Give any AI agent instant Python linting with ruff. No signup, no API key, no subscription: $0.005 USDC per call, paid automatically over x402 on Base.

  • ⚡ Fast: ruff-powered, results in milliseconds
  • 🔒 Safe: code is statically analyzed, never executed
  • 🤖 Agent-native: MCP tool lint_python for Claude, Cursor, Windsurf, Gemini/Antigravity and any MCP client
  • 💸 Pay only for what you use; the facilitator covers gas, so your wallet only needs USDC

Landing page: https://stevensaavedra.com/lint · API: POST https://api.stevensaavedra.com/lint · Verified on PayAPI Market

MCP install

json
{  "mcpServers": {    "ruff-lint": {      "command": "npx",      "args": ["-y", "@divine-software-creations/ruff-lint-x402-mcp"],      "env": { "EVM_PRIVATE_KEY": "0x<key of a Base wallet holding a little USDC>" }    }  }}

Use a dedicated low-balance wallet. $1 of USDC covers 200 lint calls.

Direct HTTP (x402)

bash
curl -i -X POST https://api.stevensaavedra.com/lint \  -H 'content-type: application/json' \  -d '{"code":"import os\nx = 1","language":"python"}'# -> 402 Payment Required with x402 payment requirements.# Any x402 client (e.g. @x402/fetch) pays and retries automatically.

Tool

lint_python({ code: string (≤200KB), filename?: string }) → ruff diagnostics (rule code, message, line/column, fix hints).

License

MIT

Source: README.md at commit b6e176f

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

1
  1. v1.0.0LatestNov 5, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.