Machina
Pay-per-call MCP tools for URL, PDF, email and domain checks, paid in USDC
- 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-mcpAdd 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.


