Skip to main content
Glama
ryotaro-tanaka

mcp-oss-onramp

mcp-oss-onramp

AI Scout for truly available, beginner-friendly OSS issues.

日本語版はこちら | Full Documentation

Quick Start

Run directly via npx:

npx mcp-oss-onramp

Direct Execution (CLI)

You can also run the server with a token directly in your terminal:

MCP_OSS_ONRAMP_GITHUB_TOKEN="your_token_here" npx mcp-oss-onramp

Related MCP server: gitea-mcp

MCP Configuration

Add this to your AI agent's configuration:

{
  "mcpServers": {
    "oss-onramp": {
      "command": "npx",
      "args": ["-y", "mcp-oss-onramp"]
    }
  }
}

Features

  • True Availability: Checks linked PRs via GraphQL to filter out issues already being worked on.

  • AI-Optimized: Summarizes issue bodies for efficient LLM consumption.

  • High Precision: Targets beginner-friendly tasks even without explicit labels.

Prerequisites

  • GitHub Authentication (Recommended):

    • Set MCP_OSS_ONRAMP_GITHUB_TOKEN environment variable, OR

    • Install GitHub CLI (gh) and authenticate via gh auth login.

  • Node.js: Version 18 or higher.

Note: The server works without authentication but will be rate-limited and provide lower precision (no PR cross-referencing).

License

MIT

Available Tools

1 tool
scout_issuesA

Scout a GitHub repository to discover truly available, beginner-friendly issues. This tool uses GitHub GraphQL for high-precision PR cross-referencing.

IMPORTANT FOR AI AGENTS: To avoid rate limits and enable high-precision scouting, ensure the MCP_OSS_ONRAMP_GITHUB_TOKEN environment variable is set with a GitHub Personal Access Token. If unauthenticated, the tool fallbacks to a lower-precision REST mode.

ParametersJSON Schema
NameRequiredDescriptionDefault
repositoryYesFull repository name (e.g., 'owner/repo')

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses fallback mode when unauthenticated and mentions high-precision mode, but does not detail rate limits, output format, or error handling. No annotations exist.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two compact paragraphs: purpose and method, then critical usage note. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, method, and authentication. Lacks detail on how 'truly available' issues are determined, which is minor given the tool's complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter, repository, with a clear schema description. Description does not add semantics beyond the schema, so baseline score applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states the tool scouts a GitHub repository for beginner-friendly issues, using GraphQL for PR cross-referencing. Verb and resource are specific and distinct.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit guidance on setting an environment variable for authentication and notes the fallback behavior without a token. No siblings to differentiate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

A3.9/5.0
Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap. The tool's purpose is distinct and well-defined.

Naming Consistency5/5

The single tool name 'scout_issues' follows a clear verb_noun pattern. Consistency is inherently maintained with one tool.

Tool Count2/5

Having only one tool is too few for the apparent scope of an OSS onboarding server. It feels thin and limits functionality.

Completeness2/5

The server covers only scouting for issues, missing other essential operations like fetching issue details or interacting with issues. This leaves significant gaps for a comprehensive tool set.

Maintenance

ActivityInactive
ResponsivenessResponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A production-ready MCP server that provides AI assistants with comprehensive GitHub developer tooling including PR analysis, code review, changelog generation, dependency auditing, commit summarization, and refactoring suggestions.
    16
    ISC
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server that enables AI assistants to read, create, and manage issues, repositories, and releases on Gitea, Forgejo, or Codeberg instances via personal access tokens.
    21
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    MCP server that finds beginner-friendly GitHub issues ranked by likelihood of successful contribution, with repo health scoring and issue status checks via the GitHub API.
    4
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ryotaro-tanaka/mcp-oss-onramp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server