Skip to main content
Glama

Opportunity MCP

A Model Context Protocol server that lets any AI assistant search youth opportunities — scholarships, fellowships, internships, conferences, and exchange programs — aggregated live from leading opportunity-discovery sites.

PyPI version Python License: MIT Tests Refresh cron MCP Registry

Status: alpha (v0.1.x). Schema, tool surface, and source list may change as adapters mature. Pin to a minor version in production.


Overview

Students who depend on third-party scholarship-aggregator sites typically open ten or more tabs, sift through dozens of irrelevant posts, and copy deadlines into a personal spreadsheet — only to miss the application window because no aggregator offers reliable deadline tracking. Opportunity MCP collapses that workflow into a single conversational query.

You: Find fully-funded master's scholarships in Europe with deadlines in the next 60 days, eligible for Pakistani citizens.

Claude: (Returns a deduplicated, structured list pulled live from the indexed sources, sorted by deadline, each linking back to the original article.)

The server runs locally over stdio, ships an SQLite + FTS5 index that refreshes every six hours via CI, and is distributed through PyPI, the official MCP Registry, and Smithery.


Related MCP server: HireHouse Jobs MCP server

Distribution channels

Channel

Identifier

Status

PyPI

opportunity-mcp

✅ live

MCP Registry

io.github.revolutionarybukhari/opportunity-mcp

✅ published

Smithery

sayedhusnainhader/opportunity-mcp

✅ published

GitHub

revolutionarybukhari/opportunity-mcp

source of truth

GitHub Releases

index-N snapshots of the SQLite DB, refreshed every 6h

auto-published by CI


Installation

Claude Desktop

pip install opportunity-mcp
opportunity-mcp-refresh           # build the local index (one-off, ~30 seconds)

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "opportunities": {
      "command": "opportunity-mcp"
    }
  }
}

Restart Claude Desktop. The six tools below become available to the model.

Cursor, Windsurf, Continue, and other MCP clients

Most clients use the same mcpServers shape. Point the command at opportunity-mcp (after pip install) or use uvx for zero-install:

{
  "mcpServers": {
    "opportunities": {
      "command": "uvx",
      "args": ["opportunity-mcp"]
    }
  }
}

Smithery (one-click install)

https://smithery.ai/server/sayedhusnainhader/opportunity-mcp — Smithery handles the install command for you.

From source

git clone https://github.com/revolutionarybukhari/opportunity-mcp
cd opportunity-mcp
uv sync                           # or: pip install -e ".[dev]"
uv run opportunity-mcp-refresh
uv run opportunity-mcp            # speaks MCP over stdio

Tools

The server exposes six tools. Each accepts JSON arguments and returns Pydantic-typed results.

Tool

Signature

Description

search_opportunities

(query, type?, funded_only?, deadline_before?, limit=20)

Full-text search across all indexed opportunities with optional filters.

get_opportunity

(id)

Retrieve full details for a single opportunity by its ID.

list_latest

(type?, limit=20)

Newest opportunities across all sources, sorted by post date.

list_upcoming_deadlines

(within_days=30, type?)

Opportunities closing within N days, sorted by deadline.

list_sources

()

List indexed sources, item counts, and last-refresh timestamps.

refresh_index

(source?)

Re-fetch sources on demand. Optional source argument limits the refresh to one site.

type is one of scholarship, fellowship, internship, conference, exchange, competition, grant, award, or other.


Indexed sources

Verified live against each site's RSS feed.

Source

Mechanism

Status

Opportunities Corners

RSS

✅ live

Opportunities for Youth

RSS

✅ live

Opportunity Desk

RSS

✅ live

Scholarships Corner

RSS

✅ live

Opportunities Circle

RSS

✅ live

Opportunities for Africans

RSS

✅ live

Scholars4Dev

RSS

✅ adapter live (feed currently empty upstream)

Youth Opportunities

HTML

planned

After School Africa

HTML

planned

Per-source robots.txt compliance, ToS notes, and CI quirks are documented in docs/SOURCES.md.


Example prompts

Find fully-funded master's scholarships in Europe with deadlines in the next 60 days.

What conferences are happening in Africa in the next three months?

List the ten newest internships indexed today.

Show me everything closing in the next seven days that an undergraduate could apply to.

Get full details for opportunity 7733b95a81e3239d.

Architecture

AI client  ──MCP──▶  FastMCP server  ──▶  SQLite + FTS5  ◀──  refresh job  ──▶  source adapters  ──▶  opportunity sites

Two clean separations of concern:

  1. Adapters know how to read one site and produce raw Opportunity objects (Pydantic-validated).

  2. The query engine knows nothing about sites — it searches a normalized index.

Adding a new source is typically a fifty-line pull request. See docs/ADAPTER_GUIDE.md. Full architecture rationale is in docs/ARCHITECTURE.md.


Privacy & ethics

  • No user tracking. All queries are processed locally; nothing leaves the user's machine except the periodic source-site refresh.

  • All indexed data is public. Summaries are capped at 500 characters and every record links back to the originating article.

  • Polite identification. The HTTP User-Agent includes the project URL so site owners can reach us directly.

  • Conservative refresh cadence. Sources are polled at most every six hours, via CI — never on user query.

  • Source removals on request are honored within 24 hours, with no negotiation.

  • robots.txt is respected by every adapter prior to fetching.


Roadmap

  • Phase 2 — country-, level-, and language-aware extraction (currently delegated to the AI client).

  • Phase 3 — first HTML adapter (Youth Opportunities), broader Tier-2/Tier-4 source coverage.

  • Phase 4 — hosted Streamable-HTTP endpoint for clients that prefer remote MCP servers.

  • Phase 5 — optional weekly digest by saved profile.

Open issues with the add a source label are good first contributions.


Contributing

Pull requests are welcome. The fastest way to help is to add a source we do not yet index — read docs/ADAPTER_GUIDE.md and open a PR. See docs/CONTRIBUTING.md for development setup, testing conventions, and the code-of-conduct expectations.

git clone https://github.com/revolutionarybukhari/opportunity-mcp
cd opportunity-mcp
uv sync
uv run pytest
uv run ruff check .

License

MIT © Opportunity MCP Contributors.

Available Tools

6 tools
get_opportunityA

Get full details for a single opportunity by ID.

Inputs: id (required). Returns: result

list_latestC

List the newest opportunities across all sources, most recent first.

Inputs: type, limit. Returns: result

list_sourcesA

List indexed sources, the count each contributed, and last-refresh time.

Inputs: no named parameters. Returns: result

list_upcoming_deadlinesA

List opportunities with deadlines in the next N days, soonest first.

Args: within_days: Look ahead this many days from today. Default 30. type: Optional filter by opportunity type.

Inputs: within_days, type. Returns: result

refresh_indexB

Refresh the local index by re-fetching sources.

Args: source: If provided, only refresh this source by name. Otherwise refresh all.

Inputs: source.

search_opportunitiesA

Full-text search across all indexed opportunities.

Args: query: Natural-language search query (e.g. "fully funded master's scholarship Germany"). type: Optional filter by opportunity type (scholarship, fellowship, internship, conference, …). funded_only: If True, only return fully-funded opportunities. deadline_before: Only return opportunities with deadlines on or before this date (ISO YYYY-MM-DD). limit: Maximum number of results. Default 20.

Inputs: query (required), type, funded_only, deadline_before, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: getting a single opportunity, listing latest, browsing sources, upcoming deadlines, refreshing data, and full-text search. No overlap in functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (get_, list_, refresh_, search_) using snake_case, making them predictable.

    Tool Count5/5

    With 6 tools covering core operations (retrieve, list, search, manage index) for an opportunity discovery server, the count is well-scoped and each tool serves a clear need.

    Completeness4/5

    The set covers key operations (retrieve, list, search, refresh) but lacks filtering options on list_latest (e.g., by type or funded status), which is a minor gap. Overall, it's adequate for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to search and retrieve opportunities from the Opportunities Circle catalog, including scholarships, fellowships, internships, grants, jobs, and more. Supports filtering by type, country, funding, and tags, with full details and official apply links.
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to search live public job listings, compare roles side by side, retrieve full job details, and render interactive job cards with application links from AI chat clients.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to discover African tech internships and early-career jobs, match candidate profiles, analyze skill gaps, track applications, and generate interview questions and preparation checklists.
      1
      MIT