# Apixies MCP Server

Connect 52+ developer utility APIs to Claude, Cursor, and any MCP-compatible AI tool.

Check SSL certificates, look up DNS records, validate emails, generate QR codes, convert HTML to PDF, and more. All through natural language.

## Quick Start

Add this to your MCP client config:

```json
{
  "mcpServers": {
    "apixies": {
      "command": "npx",
      "args": ["-y", "@apixies/mcp-server"],
      "env": {
        "APIXIES_API_KEY": "apx_your_key_here"
      }
    }
  }
}
```

Get a free API key at [apixies.io/register](https://apixies.io/register). The server needs one. Without it every tool call returns a `MISSING_API_KEY` error.

## Setup by Client

### Claude Desktop

**One click:** download [apixies.mcpb](https://apixies.io/downloads/apixies.mcpb) and double-click it. Claude Desktop asks for your API key and you're done.

**Or by hand:**

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "apixies": {
      "command": "npx",
      "args": ["-y", "@apixies/mcp-server"],
      "env": {
        "APIXIES_API_KEY": "apx_your_key_here"
      }
    }
  }
}
```

Restart Claude Desktop after saving.

### Claude Code

Add to your project's `.mcp.json` or global config:

```json
{
  "mcpServers": {
    "apixies": {
      "command": "npx",
      "args": ["-y", "@apixies/mcp-server"],
      "env": {
        "APIXIES_API_KEY": "apx_your_key_here"
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json` in your project root:

```json
{
  "mcpServers": {
    "apixies": {
      "command": "npx",
      "args": ["-y", "@apixies/mcp-server"],
      "env": {
        "APIXIES_API_KEY": "apx_your_key_here"
      }
    }
  }
}
```

### VS Code

Add to `.vscode/mcp.json`:

```json
{
  "mcpServers": {
    "apixies": {
      "command": "npx",
      "args": ["-y", "@apixies/mcp-server"],
      "env": {
        "APIXIES_API_KEY": "apx_your_key_here"
      }
    }
  }
}
```

### Windsurf

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

```json
{
  "mcpServers": {
    "apixies": {
      "command": "npx",
      "args": ["-y", "@apixies/mcp-server"],
      "env": {
        "APIXIES_API_KEY": "apx_your_key_here"
      }
    }
  }
}
```

## Available Tools

### Inspectors

| Tool | Description |
|------|-------------|
| `check_ssl` | Check SSL/TLS certificate for a domain |
| `check_headers` | Inspect security headers and get a grade |
| `inspect_email` | Validate email format, MX records, disposable detection |
| `parse_user_agent` | Detect browser, OS, device type from UA string |
| `geolocate_ip` | Get country, city, ISP for an IP address |
| `dns_lookup` | Query DNS records (A, MX, TXT, CNAME, NS, etc.) |
| `dns_propagation` | Check if a DNS change has reached five public resolvers |
| `trace_redirects` | Follow redirect chain and see every hop |
| `extract_meta_tags` | Get OpenGraph, Twitter Card, and meta tags |
| `check_link` | Check if a URL is reachable with status and timing |
| `parse_robots_txt` | Parse robots.txt rules and sitemaps |
| `fetch_favicon` | Find favicon URLs for any website |
| `validate_url` | Validate URL format, reachability, and SSL |
| `validate_email_auth` | Check SPF, DKIM, and DMARC records |
| `check_performance` | Measure DNS, TCP, SSL, TTFB, and load times |
| `whois_lookup` | Look up domain registration and expiry data |
| `decode_jwt` | Decode JWT tokens (header, payload, claims) |
| `analyze_text` | Word count, reading time, keyword frequency |
| `my_ip` | Get the server's public IP address |
| `http_status_lookup` | Look up HTTP status code details and fixes |
| `parse_cron` | Parse cron expressions into human-readable descriptions |
| `test_regex` | Test regex patterns against text with match details |
| `json_diff` | Compare two JSON objects and return structured diff |

### Converters

| Tool | Description |
|------|-------------|
| `html_to_pdf` | Convert HTML to PDF |
| `markdown_to_html` | Convert Markdown to HTML |
| `markdown_to_pdf` | Convert Markdown to PDF |
| `format_json` | Format, validate, and analyze JSON |
| `json_to_csv` | Convert JSON arrays to CSV |
| `csv_to_json` | Convert CSV data to JSON array of objects |
| `html_to_markdown` | Convert HTML content to Markdown |
| `yaml_to_json` | Convert YAML content to JSON |
| `xml_to_json` | Convert XML content to JSON |
| `json_to_xml` | Convert JSON objects to XML |
| `base64_encode_decode` | Encode or decode Base64 strings |
| `format_phone` | Format phone numbers (E.164, international) |
| `validate_json_schema` | Validate JSON against a schema |
| `convert_color` | Convert between HEX, RGB, HSL |
| `convert_timestamp` | Convert Unix timestamps to dates and back |
| `encode_decode_url` | URL-encode or decode strings |
| `generate_hash` | Generate MD5, SHA-256, SHA-512 hashes |

### Generators

| Tool | Description |
|------|-------------|
| `generate_qr` | Generate QR codes (SVG) |
| `generate_uuid` | Generate UUID v4 or v7 identifiers |
| `generate_password` | Generate secure random passwords |
| `generate_lorem` | Generate Lorem Ipsum placeholder text |
| `take_screenshot` | Capture webpage screenshots (PNG/JPEG) |

## Example Conversations

**SSL check:**
> You: Check if stripe.com has a valid SSL certificate
>
> Claude uses `check_ssl` tool, then responds with issuer, expiry date, protocol version, and chain health.

**DNS lookup:**
> You: What are the MX records for github.com?
>
> Claude uses `dns_lookup` with type "MX" and returns the mail server records.

**Multi-tool workflow:**
> You: Do a security audit on mysite.com. Check SSL, security headers, and email authentication.
>
> Claude calls `check_ssl`, `check_headers`, and `validate_email_auth` in sequence, then gives you a combined report.

## API Key

The server needs an API key. It's free: register at [apixies.io/register](https://apixies.io/register), create a key in the dashboard, and you get 75 requests a day.

Set it with the `APIXIES_API_KEY` environment variable in your MCP client config. The Claude Desktop extension asks for it when you install.

## Privacy Policy

The server runs on your machine and sends only the arguments of each tool call (a domain, a URL, some text) to the Apixies API at `https://apixies.io`, together with your API key. It doesn't read your files, your conversations or anything else on your computer, and it has no telemetry of its own.

Apixies logs API requests for up to 90 days to enforce quotas and debug problems. Payload fields such as text, HTML and email addresses are redacted from those logs. Nothing is sold or shared for advertising.

Full policy: [apixies.io/privacy](https://apixies.io/privacy). Questions: hello@apixies.io.

## Development

```bash
cd mcp-server
npm install
npm run build
npm run inspect  # Opens MCP Inspector to test tools
```

For local development with auto-reload:

```bash
npm run dev
```

To run against a local Apixies instance, set `APIXIES_BASE_URL` (for example `http://localhost:8000`). It defaults to `https://apixies.io`.

## Troubleshooting

**Tools don't appear in Claude Desktop**
- Make sure you restarted Claude Desktop after editing the config
- Check the config file path is correct for your OS
- Verify Node.js 18+ is installed: `node --version`

**"APIXIES_API_KEY not set" warning**
- The server starts, but every tool call fails with `MISSING_API_KEY`
- Add your API key to the env config and restart the client

**Rate limit errors**
- Free tier: 75 requests/day with an API key, 20 without
- Errors include a `DAILY_QUOTA_EXCEEDED` code

**Connection timeout**
- Some tools (screenshot, performance check) may take a few seconds
- If consistently timing out, check your network connection

## License

MIT