Avo for Rails MCP Server (avo-mcp_server)

Avo MCP: expose your Rails app's Avo resources, actions and Pundit policies to AI agents, so each agent sees and changes only what the user's role allows. Paid add-on for Avo 4.2+ ($30/month); runs inside your app over HTTP with OAuth.

GitHub

Documentation

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.