MCP Actions Adapter

The MCP Actions Adapter lets you expose a MCP server as a GPT actions compatible API, so you can drive actions from GPT-based chatflows without rebuilding your server client integration. It provides a local HTTP endpoint for the API schema and a ready-to-run adapter that tunnels securely to your environment.

How to use

Set up and run the adapter to enable action-based interactions with your MCP server. You will host a local API endpoint, expose it through a tunnel, and then point your GPT actions builder at the generated API schema to start testing.

How to install

Prerequisites you need before you begin.

uv tool install mcp-actions-adapter

cloudflared tunnel --url http://localhost:8000

uv run mcp-actions-adapter -c config.json --url ${CF_TUNNEL_URL}

Additional sections

Configuration notes: you will typically provide a config.json to define how the adapter connects to your MCP server. The example configuration is provided in a config.example.json file to help you tailor the setup to your environment.

Security: run the tunnel only in trusted environments and ensure you manage access to the generated API schema and tunnel URL. Rotate credentials and monitor usage to prevent unauthorized access.

Testing: after starting the tunnel and the adapter, open your custom GPT builder and paste the contents of the local API schema (openapi.json) into the schema box. Then run a few test prompts to verify that actions are discovered and invoked correctly.