Appearance
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
- Navigate to your MCP Gateway settings
- Locate HTTP Client in the Built-in Capabilities section
- Toggle the capability ON
- Configure rate limits and allowed domains (optional)
- 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
Feature | Specification |
---|---|
Timeout | Configurable (default 30s, min 1s, max 300s) |
Max Request Body | 2MB |
Max Response Body | 2MB |
Rate Limit | 1000 requests/minute |
Redirect Chain | Max 10 redirects |
Compression | gzip, 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
Related Capabilities
- Web Fetch - For HTML to Markdown conversion
- Web Search - For finding information
- Code Runner - For processing API responses
- Virtual Machine - For complex API workflows
Platform Features
- All Capabilities - Explore other built-in tools
- MCP Gateway - Configure your gateway
- Usage & Limits - Understand platform constraints