> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# http request

> Make HTTP requests to public APIs or through custom integrations

**Server path:** `/http-utils` | **Type:** Embedded | **PCID required:** No

## Tools

| Tool                                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`http-utils_request`](#http-utils_request) | Make HTTP requests to public APIs or through user-configured custom integrations.<br />**For public APIs (no PCID):**<br />- Provide the full URL (e.g., "[https://api.example.com/v1/users](https://api.example.com/v1/users)")<br />- Optionally add custom headers for authentication (e.g., API keys)<br />**For custom integrations (with PCID + service\_key):**<br />- Use mcp\_discover to find custom integrations - they appear under "User's connected custom integrations"<br />- Provide the PCID and service\_key from mcp\_discover<br />- Provide just the endpoint path - the base URL already includes any API prefix<br />- If you get a 404, try a shorter path<br />- Authentication is handled automatically (OAuth 2.0, API Key, or Basic Auth) |

***

## http-utils\_request

Make HTTP requests to public APIs or through user-configured custom integrations.

**For public APIs (no PCID):**

* Provide the full URL (e.g., "[https://api.example.com/v1/users](https://api.example.com/v1/users)")
* Optionally add custom headers for authentication (e.g., API keys)

**For custom integrations (with PCID + service\_key):**

* Use mcp\_discover to find custom integrations - they appear under "User's connected custom integrations"
* Provide the PCID and service\_key from mcp\_discover
* Provide just the endpoint path - the base URL already includes any API prefix
* If you get a 404, try a shorter path
* Authentication is handled automatically (OAuth 2.0, API Key, or Basic Auth)

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                                                                                                                                                                                                                                                            |
| -------------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string | Yes      | —       | The URL or path to call. For public APIs, provide the full URL (e.g., "[https://api.example.com/data](https://api.example.com/data)"). For custom integrations with PCID, provide just the endpoint path (e.g., "/users", "/contacts") - the base URL already includes any API prefix. |
| `service_key`  | string | No       | —       | Service key for the custom integration. Get this from mcp\_discover along with the PCID. Required when PCID is provided.                                                                                                                                                               |
| `method`       | string | No       | `"GET"` | HTTP method to use. Defaults to GET. Use POST/PUT/PATCH for creating or updating resources, DELETE for removing resources.                                                                                                                                                             |
| `body`         | string | No       | —       | Request body for POST, PUT, or PATCH requests. Can be a JSON object or a string. Will be JSON stringified if an object.                                                                                                                                                                |
| `headers`      | object | No       | —       | Custom headers for the request. Only used for public API calls (without PCID). For authenticated calls via PCID, headers are handled automatically by the proxy.                                                                                                                       |
| `query_params` | object | No       | —       | Query parameters to append to the URL. Will be URL-encoded automatically.                                                                                                                                                                                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "The URL or path to call. For public APIs, provide the full URL (e.g., \"https://api.example.com/data\"). For custom integrations with PCID, provide just the endpoint path (e.g., \"/users\", \"/contacts\") - the base URL already includes any API prefix."
      },
      "PCID": {
        "type": "string",
        "description": "Connection ID for custom integrations. Get this from mcp_discover under \"User's connected custom integrations\". Requires service_key to also be provided."
      },
      "service_key": {
        "type": "string",
        "description": "Service key for the custom integration. Get this from mcp_discover along with the PCID. Required when PCID is provided."
      },
      "method": {
        "type": "string",
        "enum": [
          "GET",
          "POST",
          "PUT",
          "PATCH",
          "DELETE"
        ],
        "default": "GET",
        "description": "HTTP method to use. Defaults to GET. Use POST/PUT/PATCH for creating or updating resources, DELETE for removing resources."
      },
      "body": {
        "oneOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "string"
          }
        ],
        "description": "Request body for POST, PUT, or PATCH requests. Can be a JSON object or a string. Will be JSON stringified if an object."
      },
      "headers": {
        "type": "object",
        "additionalProperties": true,
        "description": "Custom headers for the request. Only used for public API calls (without PCID). For authenticated calls via PCID, headers are handled automatically by the proxy."
      },
      "query_params": {
        "type": "object",
        "additionalProperties": true,
        "description": "Query parameters to append to the URL. Will be URL-encoded automatically."
      }
    },
    "required": [
      "url"
    ]
  }
  ```
</Expandable>