# RubyGems MCP for AI Agents AI Agent Connect > RubyGems MCP lets you manage Ruby packages directly through your AI agent. You can search for gems, check version history, view download stats, and manage ownership or webhooks on RubyGems.org without switching tabs. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Tfl9KPnMYgOrRtHc7svBJ6sNkO1gVCOE3hr45eda/ai-agent-connect - **Tags:** ruby, package-manager, gem-management, software-distribution, rubygems-api ## Description Imagine you're in the middle of a Ruby project and need to know if a specific library is up to date or who actually owns it. Instead of opening a browser, heading over to RubyGems.org, and digging through multiple pages of metadata, you just ask your AI client. This Connector acts as a direct bridge to the Ruby package ecosystem. It lets you pull down the latest activity, check how many times a version was downloaded, or see which other packages depend on a specific library you're using. If you're managing your own gems, you can handle things like adding owners or pushing new versions right from your workspace. It's a big time saver for anyone who spends their day navigating the Ruby community. You'll find it's one of the many specialized connectors available in the Vinkius catalog that makes working with external registries feel like a native part of your coding environment. It takes the friction out of dependency management and turns manual lookups into instant answers. ## Tools ### list_webhooks List all registered webhooks for your account. Use this to see what notifications you currently have active. ### push_gem Submit a built .gem file to RubyGems.org using base64 encoded binary data to release a new version. ### remove_gem_owner Remove an owner from a specific gem. Use this to revoke permissions from a contributor. ### remove_webhook Remove a specific registered webhook. This helps you clean up old notification triggers. ### get_reverse_dependencies List all gems that depend on a specific package. This is essential for understanding the impact of a package change. ### search_gems Search for active gems matching a query. Results are paginated to help you find the right packages quickly. ### update_gem_owner Update the role of an existing owner on a gem. Use this to promote or demote contributors. ### yank_gem Remove a specific gem version from the index. This is the standard way to pull a broken or malicious release. ### create_webhook Create a new webhook for your gems. This lets you get notified about package events automatically. ### exchange_oidc_token Swap an OIDC ID token for a short-lived API key. It's a secure way to handle authentication sessions. ### add_gem_owner Add a new owner to a specific gem. You can use this to manage permissions for your shared packages. ### fire_webhook Test fire a webhook to ensure it's working correctly. It's great for debugging your notification setup. ### get_api_key Get your API key using HTTP Basic Auth. This helps you manage your credentials securely. ### get_compact_index_info Get a text-based list of every version for a specific gem. It's a quick way to see the full history of a package. ### get_compact_index_names Get a newline-delimited list of all gem names. Use this to see the breadth of the current registry. ### get_compact_index_versions Get a compact index of all gem names, versions, and info file MD5s. This is useful for high-level registry snapshots. ### get_downloads Get the total download count for every gem in the registry. It's a high-level view of the ecosystem's popularity. ### get_gem_downloads Get download stats for a specific gem and version. This helps you see how well a specific release is performing. ### get_gem_owners View every owner associated with a specific gem. It's a simple way to check permissions and responsibility. ### get_gem Get basic information about any gem. Use this for a quick overview of a package's metadata. ### get_gem_version_details_v2 Get detailed information for a specific gem version using the v2 API. This provides deeper data than the standard version check. ### get_gem_versions Get all versions for a gem. This is the standard way to see the release history of a package. ### get_just_updated_activity Pull the 50 most recently updated gems. Use this to see what's currently trending in the Ruby community. ### get_latest_activity Pull the 50 most recently added gems. This helps you spot new entries in the registry quickly. ### get_latest_gem_version Get the latest version of a specific gem. This is the quickest way to check for the newest release. ### get_my_profile View your own profile info, including your MFA status. This lets you check your personal account settings. ### get_owner_gems View all gems a user has permission to push to. This helps you see your personal portfolio of managed packages. ### get_profile View basic user info for your account. Use this to confirm your identity on the registry. ### get_timeframe_versions Get versions created within a specific timeframe using ISO8601 dates. This is perfect for auditing recent releases. ### list_my_gems List all gems that the authenticated user owns. This gives you a clear view of your personal RubyGems portfolio. ## Prompt Examples **Prompt:** ``` Search for Ruby gems related to 'redis' and show me the top results. ``` **Response:** ``` I've searched RubyGems.org for 'redis'. The most relevant gems are: * **redis** (the official client) * **redis-namespace** * **redis-objects** Would you like the full metadata for the main 'redis' gem? ``` **Prompt:** ``` What is the latest version of the 'rails' gem and when was it released? ``` **Response:** ``` The latest version of **rails** is **7.1.3.2**. It was released on **February 21, 2024**. Would you like to see the download statistics for this version? ``` **Prompt:** ``` Show me the download count for 'sidekiq' version 7.2.0. ``` **Response:** ``` For **sidekiq** version **7.2.0**, there have been approximately **1.2 million** downloads. The total downloads for all versions of Sidekiq exceed **150 million**. ``` ## Capabilities ### Search active gems Find specific Ruby packages and their metadata using natural language queries. ### Pull version history Get a full list of releases for any gem to track updates. ### Check download stats See how many times a gem or a specific version has been downloaded. ### View reverse dependencies Identify every other package that relies on a specific gem. ### Manage gem ownership Add or remove owners and update roles for packages you maintain. ### Push new gem versions Submit built gem files to the registry to release new updates. ## Use Cases ### Dependency Audit A security lead needs to see who uses a vulnerable gem. They ask the agent to list reverse dependencies to identify affected projects. ### Version Tracking A developer wants to see if a gem has a stable version in the last month. They ask for versions in a specific timeframe. ### Ownership Management A maintainer wants to add a new contributor. They ask the agent to add a gem owner to the package metadata. ### Release Monitoring A DevOps lead wants to see if their gem is getting downloads. They ask for download stats for the latest version. ## Benefits - Stop tab-switching by using get_latest_gem_version to check for updates directly in your IDE. - Audit your supply chain faster by using get_reverse_dependencies to see who relies on your code. - Monitor your package's health with get_gem_downloads to see how users are interacting with your releases. - Manage your team's permissions easily with add_gem_owner and remove_gem_owner without leaving your terminal. - Stay on top of the community with get_just_updated_activity to see what's new in the Ruby ecosystem. - Handle releases more efficiently by using push_gem to submit new versions directly through your agent. ## How It Works The bottom line is you get instant access to the RubyGems registry without leaving your IDE. 1. Subscribe to the Connector and get your RubyGems API key from your account settings. 2. Connect your AI client to the RubyGems MCP in your settings. 3. Ask your agent to find gems, check versions, or manage your portfolio. ## Frequently Asked Questions **Can I use the RubyGems MCP to check for gem updates?** Yes. You can ask your agent to find the latest version of any gem or check the release history for a specific timeframe. **Does the RubyGems MCP help with security audits?** It does. You can use it to see reverse dependencies to understand how a specific package is being used across the ecosystem. **Can I manage my own RubyGems portfolio with this Connector?** Yes. You can list the gems you own, add or remove owners, and update roles directly through your AI client. **Is the RubyGems MCP good for tracking download trends?** Absolutely. You can pull total download counts for the entire registry or specific stats for individual gems and versions. **Can I push new versions of my gems using this Connector?** Yes. You can submit built gem files to RubyGems.org to release new versions without leaving your development environment. **How does the RubyGems MCP handle webhooks?** You can create, list, and remove webhooks to automate notifications for your Ruby packages. **Can I see which gems depend on a specific gem?** Yes! Use the `get_reverse_dependencies` tool with the gem name. It will return a list of all gems on RubyGems.org that list that gem as a dependency. **How do I check my own gems and their status?** By providing your API key, you can use the `list_my_gems` tool. This will display all gems where you have push access and ownership rights. **Can I get the full version history of a package?** Absolutely. The `get_gem_versions` tool retrieves every published version of a specific gem, allowing you to audit changes and release frequency.