Avo for Rails MCP Server (avo-mcp_server)

Avo MCP Server

Let your team ask Claude, ChatGPT, Cursor or Codex about the data in your Rails app, in plain words. avo-mcp_server serves your Avo app as a remote MCP server. Each client acts as the person who connected it, through the same resources, Pundit policies and field visibility your Avo app already applies to them.

• Product page: https://avohq.io/addons/mcp
• Docs: https://docs.avohq.io/4.0/mcp.html
• Pricing: https://avohq.io/pricing

This repository holds the README only. The gem is a commercial Avo add-on, served from Avo's private gem source to licensed apps.

What your agents get

Ten tools, scoped to what the connecting admin may see and do:

Read	Write	Actions
list_resources, list_records, count_records, show_record, search_records	create_record, update_record, delete_record	list_actions, run_action

Add your own with config.mcp_server.extra_tools.

• Remote over HTTPS, with OAuth. A teammate pastes the URL into their client and approves a consent screen served by your app. No token to paste, no stdio process.
• Per-connection grants. Each connection gets read, write or actions, optionally narrowed to some resources, and can be revoked from the admin.
• A log on every connection. Every call a connection makes is recorded on its page.
• Rate limited. 300 tool calls a minute per connection by default.

Works with Claude Code, Codex CLI, Cursor, Amp, VS Code, and ChatGPT in developer mode: any client that supports remote MCP servers with OAuth.

Install

Requires Avo 4.2 or newer, and a license with the MCP Server and Authorization add-ons. Your app must be reachable over public HTTPS.

# Gemfile
gem "avo-mcp_server", source: "https://packager.dev/avo-hq/"

bundle install
bin/rails generate avo:mcp_server install
bin/rails db:migrate

# config/routes.rb
Rails.application.routes.draw do
  mount_avo_mcp_server # outside your authentication block, before mount_avo

  authenticate :user do
    mount_avo
  end
end

# config/initializers/avo.rb
Avo.configure do |config|
  config.mcp_server.enabled = true
end

Your server answers at https://your-app.com/avo/mcp. The docs cover each client, grants, the log and custom tools.

Pricing

The MCP Server add-on is $30 a month per app and needs Authorization ($40 a month). Both are included in the AI Bundle and the Everything bundle. Unlimited users. See https://avohq.io/pricing.

Support

Questions: hi@avohq.io. Security reports: https://avohq.io/security.