Skip to content

HTTP Client

Direct access to web APIs and HTTP endpoints with full control over request construction and response handling.

Overview

HTTP Client is a built-in capability that provides AI agents with powerful API integration capabilities. When enabled on your MCP Gateway, agents gain access to all standard HTTP methods with complete control over headers, authentication, and request bodies, enabling seamless integration with any REST API or web service.

Key Features

  • All HTTP Methods: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
  • Full Header Control: Custom headers for authentication and content negotiation
  • Multiple Auth Types: Bearer tokens, API keys, Basic auth, OAuth
  • Flexible Payloads: JSON, form-encoded, multipart, raw body
  • Response Handling: Automatic parsing, status codes, headers, cookies
  • Advanced Options: Timeouts, redirects, compression, proxies

How to Enable

  1. Navigate to your MCP Gateway settings
  2. Locate HTTP Client in the Built-in Capabilities section
  3. Toggle the capability ON
  4. Configure rate limits and allowed domains (optional)
  5. Save your configuration

Once enabled, any AI agent connected to your gateway can make HTTP requests through the MCP protocol.

What AI Agents Can Do

API Integration

  • Connect to any REST API or web service
  • Retrieve data from external systems
  • Send data to third-party services
  • Orchestrate multi-service workflows
  • Synchronize information across platforms

Authentication Support

  • Handle Bearer token authentication
  • Use API keys in headers or query parameters
  • Implement Basic authentication
  • Manage OAuth 2.0 flows
  • Support custom authentication schemes

Data Exchange

  • Send and receive JSON payloads
  • Process form-encoded data
  • Handle multipart uploads
  • Work with XML and other formats
  • Manage binary data transfers

Webhook Operations

  • Send webhook notifications
  • Receive webhook callbacks
  • Implement event-driven architectures
  • Trigger external automations
  • Handle real-time updates

Supported Methods

Request Methods

  • GET: Retrieve resources
  • POST: Create new resources
  • PUT: Update existing resources
  • DELETE: Remove resources
  • PATCH: Partially update resources
  • HEAD: Retrieve headers only
  • OPTIONS: Discover allowed methods

Content Types

  • application/json
  • application/x-www-form-urlencoded
  • multipart/form-data
  • text/plain
  • application/xml
  • Custom content types

Capability Behavior

Automatic Features

  • Response parsing based on content type
  • Automatic decompression (gzip, deflate, brotli)
  • Cookie management within session
  • Redirect following (configurable)
  • Connection pooling for performance

Error Handling

  • Automatic retry with exponential backoff
  • Status code interpretation
  • Network error recovery
  • Timeout management
  • Rate limit detection

Security Features

  • SSL/TLS certificate validation
  • Domain allowlist support
  • Header filtering for sensitive data
  • Request size limits
  • Response size limits

Performance & Limits

FeatureSpecification
TimeoutConfigurable (default 30s, min 1s, max 300s)
Max Request Body2MB
Max Response Body2MB
Rate Limit1000 requests/minute
Redirect ChainMax 10 redirects
Compressiongzip, deflate, brotli

Common Integrations

Payment Systems

AI agents use HTTP Client to integrate with payment processors like Stripe, PayPal, or Square for transaction processing, subscription management, and financial reporting.

Cloud Services

Agents interact with cloud platforms such as AWS, Google Cloud, or Azure to manage resources, retrieve metrics, and orchestrate infrastructure operations.

Communication APIs

Agents send notifications through services like SendGrid, Twilio, or Slack to deliver messages, alerts, and updates to users across multiple channels.

Data Sources

Agents fetch data from various APIs including weather services, financial markets, news feeds, and public datasets to enrich analysis and decision-making.

Enterprise Systems

Agents connect to CRM systems like Salesforce, ERP platforms like SAP, or project management tools like Jira to synchronize data and automate workflows.

Response Information

Available Response Data

  • Status code and status text
  • Response headers
  • Parsed body content
  • Cookie values
  • Timing metrics
  • Redirect chain

Content Processing

  • JSON automatically parsed
  • XML converted to structured data
  • HTML available as text
  • Binary data as base64
  • Text content as strings

Rate Limiting

Built-in Protection

  • Automatic rate limit detection
  • Respect for Retry-After headers
  • Exponential backoff strategies
  • Queue management for burst requests

Custom Limits

  • Configure per-domain limits
  • Set global request caps
  • Define time windows
  • Implement priority queues

Typical Applications

Data Synchronization

AI agents use HTTP Client to keep data synchronized between multiple systems, ensuring consistency across platforms and preventing data silos.

Monitoring and Alerting

Agents continuously check API endpoints for status, performance metrics, or data changes, sending alerts when thresholds are exceeded or issues detected.

Workflow Automation

Agents orchestrate complex workflows by coordinating multiple API calls, managing sequential operations, and handling conditional logic based on responses.

Report Generation

Agents gather data from multiple API sources, aggregate information, perform analysis, and generate comprehensive reports for decision-making.

Pricing

HTTP Client is included with standard MCP Gateway usage:

  • No per-request charges
  • Standard gateway request rates apply
  • Large responses (>200KB) count as multiple requests

Next Steps

Platform Features