Hyperclient Mcp

Turn any hypermedia api into an mcp server.

Add to Gemfile.

gem 'hyperclient-mcp'

Run bundle install.

The S'Up service at sup2.playplay.io generates fresh triads of team members in Slack to meet for coffee every week in an informal standup. It has a Hypermedia API under sup2.playplay.io/api that can be enabled with set api on and accessed with a token obtained using set api token. We'll export TOKEN in a shell for future use.

export TOKEN=...

The Hypermedia client to this api is as follows.

api = Hyperclient.new('https://sup2.playplay.io/api') do |client|
  client.headers['X-Access-Token'] = ENV.fetch('TOKEN', nil)
end

Start the Hyperclient MCP server for any existing API using the convenient command-line proxy.

hyperclient-mcp --api https://sup2.playplay.io/api --header X-Access-Token=$TOKEN start

Register with Claude.

claude mcp add --transport sse local http://127.0.0.1:9292/mcp/sse

Check that it was registered.

$ claude mcp list
Checking MCP server health...
local: http://127.0.0.1:9292/mcp/sse (SSE) - ✓ Connected

Run Claude, try asking a question.

$ claude "use the local mcp to find the name of the team with ID 64124ac95d758400015faecf"

The team name is dblock.

To turn any hypermedia API into an MCP in code, create an mcp wrapper and register its resources with FastMcp and mount it as usual.

hyperclient_mcp = Hyperclient::Mcp::Api.new(api)

mcp_server = FastMcp::Server.new(name: "S'Up", version: '0.0.1')
mcp_server.register_resources(*hyperclient_mcp.resources)

use FastMcp::Transports::RackTransport, mcp_server

For example, the MCP code in examples/sup.playplay.io starts an MCP server using code similar to above, and can be directly used with Claude.

bundle install
bundle exec ruby mcp.rb

claude mcp add --transport sse local http://127.0.0.1:4567/mcp/sse

See examples/grape-with-roar for a complete example that uses the grape-with-roar demo project.

See UPGRADING.

See CONTRIBUTING.

Copyright (c) 2025, Daniel Doubrovkine and Contributors.

This project is licensed under the MIT License.