Skip to content

feat: add proxy IP whitelist management tools#35

Open
jrejaud wants to merge 2 commits intoDecodo:mainfrom
jrejaud:add-proxy-management-tools
Open

feat: add proxy IP whitelist management tools#35
jrejaud wants to merge 2 commits intoDecodo:mainfrom
jrejaud:add-proxy-management-tools

Conversation

@jrejaud
Copy link
Copy Markdown

@jrejaud jrejaud commented Mar 10, 2026

Summary

Adds three new MCP tools for managing Decodo proxy IP whitelists via the v2 API (api.decodo.com/v2):

  • list_whitelisted_ips — List all whitelisted IPs on the account
  • add_whitelisted_ips — Add one or more IPv4 addresses to the whitelist
  • remove_whitelisted_ip — Remove a whitelisted IP by its ID

These tools enable AI agents to programmatically manage proxy authentication whitelists without manual dashboard access — useful for automated server provisioning workflows.

Implementation details

  • New ProxyApiClient class for the Decodo v2 API (uses API key auth via Authorization: Token <key> header)
  • Tools are conditionally registered only when DECODO_API_KEY env var is set, so existing scraping-only setups are unaffected
  • Follows the existing tool class pattern (static register() method)
  • IPv4 validation via Zod schema on the add tool

Configuration

Users opt in by setting the DECODO_API_KEY environment variable (generated at dashboard.decodo.com > Account Settings > API Keys).

Test plan

  • Existing tests pass (npm test)
  • Build succeeds (npm run build)
  • Manual testing with a Decodo account and API key

jrejaud and others added 2 commits March 11, 2026 00:21
Add three new MCP tools for managing Decodo proxy IP whitelists via the
v2 API: list_whitelisted_ips, add_whitelisted_ips, remove_whitelisted_ip.

These tools are conditionally registered when the DECODO_API_KEY env var
is set, keeping backwards compatibility for existing scraping-only users.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Auth header uses raw API key, not Token prefix
- POST /whitelisted-ips returns empty body, so re-fetch list after add
- Tested all 3 tools against live Decodo API

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@domantas-jurkus-dcd
Copy link
Copy Markdown
Member

Hello! Thanks for making a contribution, IP whitelist management is a good new feature suggestion. We're coming back to developing the MCP server more actively, so we'll make an effort to pick up your suggestions and roll them into our release pipeline!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants