README.md
HTTP client capabilities with browser impersonation for multiple browsers
Primp MCP Server
A Model Context Protocol (MCP) server that provides access to the 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
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):
# 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:
# 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:
{
"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
Tools (2)
primp_requestMake HTTP requests with browser impersonation including custom headers and return formats.primp_uploadUpload files using multipart form data with support for base64 encoded content.Configuration
claude_desktop_config.json
{"mcpServers": {"primp": {"command": "primp-mcp"}}}Try it
→Fetch the content of https://example.com/api while impersonating Chrome 131 on Windows.
→Make a POST request to https://httpbin.org/post with a Bearer token and return the response as JSON.
→Upload a text file named 'data.txt' with the content 'Hello World' to the server at https://httpbin.org/post.
→Get the markdown version of the webpage at https://example.com using Safari 18 impersonation.