# Smartproxy — how to use (mcp.ai)

Connect your Smartproxy account and use 6 tools for web scraping straight from your AI agent. Connect with your own API key. Smartproxy (now Decodo) offers a comprehensive suite of proxy and web scraping solutions, providing users with access to a vast network of residential, datacenter, ISP, and mobile proxies, along with scraping APIs for efficient data collection.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_smartproxy?ms=1787293680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `smartproxy_delete_whitelisted_ip`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/smartproxy`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/smartproxy/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/smartproxy/delete/whitelisted/ip` — Tool to delete a specified whitelisted IP by its ID. Use when you need to remove an IP address from the whitelist. Returns success confirmation on completion.
  - body: { id: string }
- `POST https://api.mcp.ai/api/smartproxy/generate/backconnect/endpoints` — Tool to generate custom back connect endpoints for Residential subscription proxies. Use when you need to create proxy connection strings with specific configuration parameters like session type, loca
  - body: { ip?: string, city?: string, page?: integer, count?: integer, state?: string, domain?: string, country?: string, password: string, protocol?: string, username: string, line_break?: string, session_time?: integer, session_type?: string, output_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/smartproxy/generate/custom/endpoints` — Tool to generate custom proxy endpoints for Residential and Datacenter Pay per GB subscriptions. Use when you need to create configured proxy endpoints with specific authentication, session, and locat
  - body: { ip?: string, page?: integer, count?: integer, domain?: string, location?: string, password?: string, username?: string, auth_type?: string, line_break?: string, proxy_type?: string, session_time?: integer, session_type?: string, output_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/smartproxy/get/api/key` — Tool to instruct how to obtain Smartproxy API key. Use when you need to authenticate API requests but don't have your key (manual dashboard process).
- `POST https://api.mcp.ai/api/smartproxy/get/endpoints/by/type` — Tool to retrieve proxy endpoints by type (random or sticky) for Residential subscription. Returns location, hostname, and port_range for each endpoint. Use when you need specific endpoint configuratio
  - body: { type: string }
- `POST https://api.mcp.ai/api/smartproxy/list/endpoints/and/ports` — Tool to retrieve all available proxy endpoints and corresponding ports. Use when you need to fetch the full inventory of Smartproxy endpoints.

## Example prompts
- "What can I do in Smartproxy?"
- "Show me a summary of my Smartproxy account"

## More
- Page: https://mcp.ai/smartproxy
- Agent spec (llms.txt): https://mcp.ai/smartproxy/llms.txt
- Postman collection: https://mcp.ai/smartproxy/postman.json