get_owner_gems
Retrieve all RubyGems owned by a specific user or organization using the RubyGems API. Input the owner’s username to fetch a detailed list of associated gems.
Instructions
Get all RubyGems owned by a specific user or organization
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| $schema | No | ||
| additionalProperties | No | ||
| properties | No | ||
| required | No | ||
| type | No |
Implementation Reference
- src/tools/get_owner_gems.ts:62-78 (handler)The MCP tool handler for 'get_owner_gems', which parses input arguments, fetches the gems using getOwnerGems, and returns the JSON-formatted result or an error response.
handler: async (args: Record<string, unknown> | undefined) => { const { owner_name } = GetOwnerGemsInputSchema.parse(args || {}); try { const ownerGems = await getOwnerGems(owner_name); return { content: [ { type: 'text', text: JSON.stringify(ownerGems, null, 2), }, ], }; } catch (error: unknown) { return createErrorResponse(error, 'Failed to fetch gems for owner'); } }, - src/tools/get_owner_gems.ts:38-52 (handler)Core implementation that performs the HTTP fetch to RubyGems API for owner's gems and parses/validates the response using OwnerGemSchema.
async function getOwnerGems(ownerName: string): Promise<OwnerGem[]> { const response = await fetch( `https://rubygems.org/api/v1/owners/${ownerName}/gems.json` ); if (!response.ok) { if (response.status === 404) { throw new Error(`Owner '${ownerName}' not found`); } throw new Error(`Failed to fetch gems for owner: ${response.statusText}`); } const data = await response.json(); return z.array(OwnerGemSchema).parse(data); } - src/tools/get_owner_gems.ts:30-35 (schema)Input schema for the tool using Zod, defining the required 'owner_name' parameter.
const GetOwnerGemsInputSchema = z.object({ owner_name: z .string() .min(1) .describe('Username of the RubyGem owner to fetch gems for'), }); - src/tools/get_owner_gems.ts:7-25 (schema)Output schema defining the structure of each gem returned by the RubyGems API.
const OwnerGemSchema = z.object({ name: z.string(), downloads: z.number(), version: z.string(), version_downloads: z.number(), platform: z.string(), authors: z.string(), info: z.string(), licenses: z.array(z.string()).nullable(), project_uri: z.string(), gem_uri: z.string(), homepage_uri: z.string().nullable(), wiki_uri: z.string().nullable(), documentation_uri: z.string().nullable(), mailing_list_uri: z.string().nullable(), source_code_uri: z.string().nullable(), bug_tracker_uri: z.string().nullable(), funding_uri: z.string().nullable(), }); - src/index.ts:13-27 (registration)Imports the getOwnerGemsTool and includes it in the tools array used by the MCP server for tool listing and calling.
import { getOwnerGemsTool } from './tools/get_owner_gems.js'; import { searchRubyGemsTool } from './tools/search_rubygems.js'; import { type McpTool } from './tools/types.js'; /** * Define the array of available tools */ const tools: readonly McpTool[] = [ getRubyGemInfoTool, searchRubyGemsTool, getGemVersionsTool, getGemReverseDependenciesTool, getOwnerGemsTool, getGemOwnersTool, ] as const;