How should rails-mcp-server be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

rails-mcp-server answer-first brief

MCP server for accessing Ruby on Rails documentation and guides Rails Guides MCP Server A **Model Context Protocol (MCP) server** that provides access to Ruby on Rails documentation and guides. This server allows AI assistants like Claude to access, search, and reference Rails Guides content programmatically, making it easier to get Rails development help and documentation. 🚀 Features - **Complete Rails Guides access** - All official Rails documentation categories - **Version su Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

rails-mcp-server is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 93/100

rails-mcp-server

MCPverified

Public facts

Change events

Artifacts

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Alkevintan

Artifacts

Benchmarks

Last release

1.0.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/alkevintan/rails-mcp-server.git

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Alkevintan

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

bash

# Navigate to your Rails project directory
cd your-rails-project

# Add the Rails Guides MCP server to your project
claude mcp add rails-guides npx rails-mcp-server

# For specific Rails version
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=7.1

bash

# Add globally for all Claude sessions
claude mcp add rails-guides npx rails-mcp-server --scope user

# With specific Rails version
claude mcp add rails-guides npx rails-mcp-server --scope user -e RAILS_VERSION=7.1

bash

# Add for local Claude sessions only
claude mcp add rails-guides npx rails-mcp-server --scope local

bash

# Default (Rails 8.0)
claude mcp add rails-guides npx rails-mcp-server

# Rails 7.1
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=7.1

# Rails 4.2
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=4.2

# Rails 6.0
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=6.0

bash

claude mcp add rails-guides npx rails-mcp-server -e RAILS_GUIDES_VERSION=7.1

bash

git clone https://github.com/your-username/rails-mcp-server.git
cd rails-mcp-server

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

Rails Guides MCP Server

A Model Context Protocol (MCP) server that provides access to Ruby on Rails documentation and guides. This server allows AI assistants like Claude to access, search, and reference Rails Guides content programmatically, making it easier to get Rails development help and documentation.

🚀 Features

Complete Rails Guides access - All official Rails documentation categories
Version support - Support for multiple Rails versions (8.0, 7.1, 4.2, etc.)
Categorized organization - Guides organized by topic (Models, Views, Controllers, etc.)
Dynamic version switching - Environment variable support for different Rails versions
TypeScript implementation with Zod schema validation
Development tools including hot reload and inspector
Ready for Claude integration with simple setup commands

📋 Prerequisites

Node.js 18 or higher
npm, yarn, or pnpm
Claude desktop app (for integration)

🤝 Intended Use Cases

This MCP server is perfect for:

Rails developers seeking quick access to official documentation
AI-assisted Rails development with Claude or other MCP-compatible tools
Learning Rails with contextual documentation access
Code review and debugging with instant access to Rails conventions
Teams wanting consistent Rails documentation access across projects

🚀 Quick Start with Claude

Option 1: Add to Claude Project (Recommended)

# Navigate to your Rails project directory
cd your-rails-project

# Add the Rails Guides MCP server to your project
claude mcp add rails-guides npx rails-mcp-server

# For specific Rails version
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=7.1

Option 2: Add Globally

# Add globally for all Claude sessions
claude mcp add rails-guides npx rails-mcp-server --scope user

# With specific Rails version
claude mcp add rails-guides npx rails-mcp-server --scope user -e RAILS_VERSION=7.1

Option 3: Add Locally

# Add for local Claude sessions only
claude mcp add rails-guides npx rails-mcp-server --scope local

🔧 Rails Version Support

The server defaults to Rails 8.0 documentation but supports multiple versions:

Supported Versions

Rails 8.0 (default) - https://guides.rubyonrails.org
Rails 7.1 - https://guides.rubyonrails.org/v7.1
Rails 4.2 - https://guides.rubyonrails.org/v4.2
Other versions - Follow the pattern v{major}.{minor}

Setting Rails Version

Use the RAILS_VERSION environment variable:

# Default (Rails 8.0)
claude mcp add rails-guides npx rails-mcp-server

# Rails 7.1
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=7.1

# Rails 4.2
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=4.2

# Rails 6.0
claude mcp add rails-guides npx rails-mcp-server -e RAILS_VERSION=6.0

Alternative Environment Variable

You can also use RAILS_GUIDES_VERSION:

claude mcp add rails-guides npx rails-mcp-server -e RAILS_GUIDES_VERSION=7.1

🛠️ Manual Installation (Development)

If you want to modify or contribute to this server:

Clone the repository:

git clone https://github.com/your-username/rails-mcp-server.git
cd rails-mcp-server

Install dependencies:

npm install

Build the project:

npm run build

Test locally:

node dist/server.js

🏃‍♂️ Development

Start Development Server

npm run dev

Build for Production

npm run build

Inspect MCP Server

npm run inspect

This opens the MCP Inspector to test your server tools interactively.

📚 Available Tools

The Rails Guides MCP server provides the following tools:

Core Tools

getRailsGuides - Returns a comprehensive list of all Rails Guides with categories and metadata
getGuideRegistry - Complete registry with all guides, categories, and version info
getGuideContent - Fetches the full HTML content of a specific Rails Guide

Category-specific Tools

Dynamic tools are created for each Rails Guide category:

getStartHereGuides - Getting Started, Installation guides
getModelsGuides - Active Record, Migrations, Validations, Associations, etc.
getViewsGuides - Action View, Layouts, Helpers, Form Helpers
getControllersGuides - Action Controller, Routing, Advanced Topics
getOtherComponentsGuides - Active Support, Action Mailer, Active Job, etc.
getDiggingDeeperGuides - I18n, Testing, Debugging, Configuration, etc.
getGoingToProductionGuides - Caching, Security, Performance
getAdvancedActiveRecordGuides - PostgreSQL, Multiple DBs, Encryption
getExtendingRailsGuides - Plugins, Rack, Generators, Engines
getContributingGuides - Contributing, API docs, Development setup

Example Usage

Once added to Claude, you can ask questions like:

"Show me the Rails guides for Models"
"Get the Getting Started guide content"
"What Rails guides are available for testing?"
"Fetch the Active Record associations guide"

🏗️ Project Structure

rails-mcp-server/
├── src/
│   ├── server.ts              # Main Rails Guides MCP server
│   ├── lib/
│   │   ├── config.ts          # Configuration with version support
│   │   └── categories.ts      # Rails Guides categories
│   └── utils/
│       ├── api.ts             # Rails Guides fetching utilities
│       ├── formatters.ts      # Data formatting helpers
│       ├── schemas.ts         # Zod validation schemas
│       └── index.ts           # Utility exports
├── dist/                      # Built files
├── package.json
└── README.md

🔧 Customization

Adding New Rails Guide Categories

To add new guide categories, update src/lib/categories.ts:

export const guideCategories = {
  // Existing categories...
  "Custom Category": [
    "custom_guide_1",
    "custom_guide_2", 
  ],
};

The server will automatically create category-specific tools.

Supporting Different Rails Versions

The server automatically handles different Rails versions through URL patterns:

Rails 8.0+: https://guides.rubyonrails.org/{guide}.html
Older versions: https://guides.rubyonrails.org/v{version}/{guide}.html

Customizing Guide Processing

Modify src/utils/api.ts to customize how guides are processed:

export async function fetchGuideDetails(guideName: string) {
  // Add custom processing logic
  // Parse HTML sections, extract code examples, etc.
}

🚀 Deployment

Publishing as NPM Package

To make this server available via npx, publish it to npm:

Update package.json with your details:

{
  "name": "rails-mcp-server",
  "version": "1.0.0",
  "description": "MCP server for Rails Guides documentation",
  "bin": {
    "rails-mcp-server": "./dist/server.js"
  }
}

Build and publish:

npm run build
npm publish

Then users can add it with:

claude mcp add rails-guides npx rails-mcp-server

Manual Installation

For development or custom deployments:

# Clone and build
git clone https://github.com/your-username/rails-mcp-server.git
cd rails-mcp-server
npm install && npm run build

# Add to Claude with local path
claude mcp add rails-guides node /path/to/rails-mcp-server/dist/server.js

🤝 Contributing

Contributions are welcome! Here's how you can help:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and add tests if applicable
Commit your changes: git commit -m 'feat: add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with Model Context Protocol SDK
Rails Guides content from Ruby on Rails
Inspired by the need for better AI-assisted Rails development
Thanks to the MCP and Rails communities

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Rails Guides: Official Rails Guides

✨ Happy Rails development with AI assistance!

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/snapshot"

curl -s "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract"

curl -s "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/alkevintan/rails-mcp-server#input",
  "outputSchemaRef": "https://github.com/alkevintan/rails-mcp-server#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:12.474Z",
  "sourceUpdatedAt": "2026-02-24T19:46:12.474Z",
  "freshnessSeconds": 4443549
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T06:05:21.896Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "rails",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ruby-on-rails",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "documentation",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "guides",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "model-context-protocol",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ai",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "claude",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "server",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:rails|supported|profile capability:ruby-on-rails|supported|profile capability:documentation|supported|profile capability:guides|supported|profile capability:mcp|supported|profile capability:model-context-protocol|supported|profile capability:ai|supported|profile capability:claude|supported|profile capability:server|supported|profile capability:cli|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:12.474Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:12.474Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/alkevintan/rails-mcp-server#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:12.474Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Alkevintan",
    "href": "https://github.com/alkevintan/rails-mcp-server",
    "sourceUrl": "https://github.com/alkevintan/rails-mcp-server",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-alkevintan-rails-mcp-server/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]