# Primp MCP Server

A Model Context Protocol (MCP) server that provides access to the [primp](https://github.com/deedy5/primp) HTTP client library with browser impersonation capabilities.

## Features

- **Browser Impersonation**: Impersonate various browsers (Chrome, Firefox, Safari, Edge) and operating systems
- **HTTP Methods**: Support for GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
- **Authentication**: Basic auth and Bearer token support
- **Proxy Support**: HTTP/HTTPS proxy support
- **File Uploads**: Multipart form data file uploads
- **Response Formats**: Return responses as text, JSON, markdown, plain text, or rich text
- **Advanced Options**: Configurable timeouts, redirect handling, SSL verification

## Installation

```bash
pip install -e .
```

## Usage

The server provides two main tools:

### 1. `primp_request`

Make HTTP requests with browser impersonation (note, these instructions are for the LLM):

```python
# Example usage in MCP client
{
    "name": "primp_request",
    "arguments": {
        "url": "https://httpbin.org/get",
        "method": "GET",
        "impersonate": "chrome_131",
        "impersonate_os": "windows",
        "headers": {
            "User-Agent": "My-App/1.0"
        },
        "return_format": "json"
    }
}
```

### 2. `primp_upload`

Upload files using multipart form data:

```python
# Example usage in MCP client
{
    "name": "primp_upload",
    "arguments": {
        "url": "https://httpbin.org/post",
        "files": [
            {
                "name": "file",
                "filename": "example.txt",
                "content": "SGVsbG8gV29ybGQ=",  # base64 encoded
                "content_type": "text/plain"
            }
        ],
        "data": {
            "description": "Test upload"
        }
    }
}
```

## Configuration

Add to your MCP settings:

```json
{
  "mcpServers": {
    "primp": {
      "command": "primp-mcp"
    }
  }
}
```

## Supported Browsers

- Chrome (versions 99-131)
- Firefox (versions 99-133)
- Safari (versions 12-18, including iPad/iPhone)
- Edge (versions 99-131)
- OkHttp (versions 3.14.9-5.0.0)

## Supported Operating Systems

- Windows
- macOS
- Linux
- Android
- iOS

## License

MIT