# agproxy Residential Proxy Fetch (MPP)

> agproxy Residential Proxy Fetch (MPP) is a paid API for AI agents from agproxy.shveik.dev, paid per call via x402, $0.0156/call, status unknown (last checked 2026-10-14).

Fetches a URL through a residential IP address from a specified country and returns the raw HTTP response as JSON, billed per call in stablecoins via MPP on Base.

## Facts

- Endpoint: POST https://agproxy.shveik.dev/mpp/fetch?utm_source=zero.xyz
- Price: $0.0156/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agproxy-residential-proxy-fetch-mpp-c6ee5eb0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lPZuqyJJS2EzdGPIx8Pmi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agproxy-residential-proxy-fetch-mpp-c6ee5eb0 -d '<json body>'
```

Example prompt: Fetch https://www.example.com/products through a residential IP in Germany using a GET request and give me the full response body — up to 5 MB.

## When to prefer this

Choose this endpoint when you need a single URL fetched through a genuine residential IP — not a datacenter — without managing proxy credentials or sessions. Ideal for one-off fetches where geo-targeting matters, bot detection is a concern, or you want to pay per call rather than buy a traffic bundle. Prefer this over the pack-based proxy product when volume is low or unpredictable, and over generic HTTP fetch tools when the target site blocks datacenter IPs.

## Known failure modes

- URL unreachable or times out from the residential IP — returns an error status or timeout message
- Requested country has no available residential IPs — may return an error or fall back
- Response exceeds max_mb limit — body is truncated and truncated flag is set to true
- Invalid country code format — schema validation error
- Payment failure or insufficient USDC balance — request rejected before proxying
- Target site returns non-2xx status — still returned faithfully with the actual status code

## How this service works

Residential proxies for AI agents. Buy a pack of traffic and use it like any HTTP proxy, with a country and a sticky session in the username. Or skip the proxy: one fetch call returns the raw response from a residential IP. Pay per call in stablecoins. (x402 on Base and Polygon or MPP on Base)

## Output

A JSON object containing: the response body as a string, HTTP status code, final URL after redirects, response headers, number of bytes received, wire bytes used, elapsed time in milliseconds, country of the exit IP, and a boolean indicating if the response was truncated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2000
  },
  "body": {
   "type": "string",
   "maxLength": 1048576
  },
  "max_mb": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "method": {
   "enum": [
    "GET",
    "HEAD",
    "POST"
   ],
   "type": "string"
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$"
  },
  "headers": {
   "type": "object",
   "additionalProperties": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "body": "<!doctyp…",
  "bytes": 577,
  "status": 200,
  "country": null,
  "headers": {},
  "final_url": "https://…",
  "truncated": false,
  "elapsed_ms": 2309,
  "wire_bytes": 8685
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agproxy-residential-proxy-fetch-mpp-c6ee5eb0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agproxy.shveik.dev](https://www.zero.xyz/host/agproxy.shveik.dev/llms.txt)