mcp-rest-api

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AUTH_BEARERNoYour Bearer token for authentication.
REST_BASE_URLYesThe base URL of the REST API.
AUTH_APIKEY_VALUENoThe API Key value for authentication.
AUTH_BASIC_PASSWORDNoYour password for Basic Authentication.
AUTH_BASIC_USERNAMENoYour username for Basic Authentication.
REST_ENABLE_SSL_VERIFYNoSet to false to disable SSL verification for self-signed certificates.true
AUTH_APIKEY_HEADER_NAMENoThe header name for API Key authentication.
REST_RESPONSE_SIZE_LIMITNoMaximum response size in bytes.10000

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
REST API Usage ExamplesDetailed examples of using the REST API testing tool
Response Format DocumentationDocumentation of the response format and structure
Configuration DocumentationDocumentation of all configuration options and how to use them

Tools

Functions exposed to the LLM to take actions

NameDescription
test_requestTest a REST API endpoint and get detailed response information. Base URL: https://api.example.com/v1 SSL Verification: Disabled (see config resource for SSL settings) Authentication: Basic Auth with username: user_example The tool automatically: - Normalizes endpoints (adds leading slash, removes trailing slashes) - Handles authentication header injection - Accepts any HTTP status code as valid - Limits response size to 5000 bytes (see config resource for size limit settings) - Returns detailed response information including: * Full URL called * Status code and text * Response headers * Response body * Request details (method, headers, body) * Response timing * Validation messages Error Handling: - Network errors are caught and returned with descriptive messages - Invalid status codes are still returned with full response details - Authentication errors include the attempted auth method See the config resource for all configuration options.