Skip to content
MCP server

Machina

Pay-per-call MCP tools for URL, PDF, email and domain checks, paid in USDC

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About Machina

Machina is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Machina turns a set of small web utilities into MCP tools that bill per request instead of by subscription. Each call is settled automatically with the x402 payment protocol, using an Ethereum wallet key you supply, so the agent just calls a tool and gets a result back.

The eight tools cover fetching a URL as Markdown, scanning Python code for security problems, validating one email or up to 100, looking up DNS, WHOIS, SSL and tech-stack details for a domain, and turning PDFs into Markdown. Checking a PDF's page count and metadata is free; the rest carry listed prices from $0.005 to $0.50 per call.

It runs locally over stdio as a Python package and forwards requests to the Machina API at mach402.dev. You need a wallet holding a small USDC balance on Base, and the README suggests $1 to $5 to start. A testnet mode with mock payments is available for trying it out.

Install

Run in a terminal

claude mcp add machina-mcp --env MACHINA_WALLET_KEY='<MACHINA_WALLET_KEY>' -- uvx machina-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "machina-mcp": {
      "command": "uvx",
      "args": [
        "machina-mcp"
      ],
      "env": {
        "MACHINA_WALLET_KEY": "<MACHINA_WALLET_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "machina-mcp": {
      "command": "uvx",
      "args": [
        "machina-mcp"
      ],
      "env": {
        "MACHINA_WALLET_KEY": "<MACHINA_WALLET_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "machina-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "machina-mcp"
      ],
      "env": {
        "MACHINA_WALLET_KEY": "<MACHINA_WALLET_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "machina-mcp": {
      "command": "uvx",
      "args": [
        "machina-mcp"
      ],
      "env": {
        "MACHINA_WALLET_KEY": "<MACHINA_WALLET_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "machina-mcp": {
      "command": "uvx",
      "args": [
        "machina-mcp"
      ],
      "env": {
        "MACHINA_WALLET_KEY": "<MACHINA_WALLET_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MACHINA_WALLET_KEYEthereum private key (hex, 0x-prefixed) for x402 payments in USDC on BaseRequired

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

url_extract
Fetch any URL and return clean Markdown.
scan_python
Scan Python code for security vulnerabilities.
validate_email
Validate a single email by syntax, MX and SMTP.
validate_email_bulk
Validate up to 100 emails at once.
domain_intel
DNS, WHOIS, SSL and tech stack for a domain.
pdf_inspect
PDF page count and metadata; free.
pdf_extract
Convert a PDF of up to 50 pages to Markdown.
pdf_extract_large
Convert a PDF of up to 200 pages to Markdown.

What it does

Per-call x402 payments
Each tool call pays itself in USDC on Base from your wallet key, with no subscription.
URL to Markdown
Fetches a web page and returns clean Markdown for the agent.
Python security scan
Scans pasted Python code for security vulnerabilities.
Email validation
Checks syntax, MX and SMTP for one address, or up to 100 in bulk.
Domain intelligence
Returns DNS, WHOIS, SSL and tech-stack details for a domain.
PDF extraction
Converts PDFs to Markdown, with separate tools for up to 50 and up to 200 pages.

Good for

  • Pull a web page into an agent's context as Markdown
  • Scan a Python snippet for vulnerabilities before running it
  • Clean up a mailing list by validating addresses in bulk
  • Research a domain's DNS, certificate and tech stack
  • Extract text from long PDF reports

Pricing

Open source

Server is MIT-licensed; API calls are billed per use in USDC, from $0.005 (pdf_inspect is free)

Machina FAQ

What does each call cost?

Listed prices run from free for pdf_inspect up to $0.50 for bulk email validation; a URL extraction is $0.005 and a Python scan $0.02.

How are payments made?

In USDC on the Base network. The server signs an x402 payment with the wallet key you set in MACHINA_WALLET_KEY.

Can I try it without spending money?

Yes. Setting MACHINA_NETWORK to the Base testnet value switches to mock payments.

What licence is it under?

MIT.

Is Machina free?

Yes. Machina is open source, so you can use and self-host it for free.

How do I add Machina to Claude Code?

Run this command in your terminal: claude mcp add machina-mcp --env MACHINA_WALLET_KEY='<MACHINA_WALLET_KEY>' -- uvx machina-mcp

What are the best alternatives to Machina?

The closest alternatives to Machina are REA, Scrapling MCP Server, Context7, Chrome DevTools MCP and Codebase Memory.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers