# Machina

> Machina is an open-source MCP server for developer tools. Pay-per-call MCP tools for URL, PDF, email and domain checks, paid in USDC. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/nyterry/machina-mcp
- **MCP Registry name:** io.github.NyTerry/machina-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/machina
