Skip to main content
Glama
Anicodeth

opportunities-circle-mcp

by Anicodeth

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OPPCIRCLE_BASE_URLNoSite to query.https://www.opportunitiescircle.com
OPPCIRCLE_TIMEOUT_MSNoPer-request network timeout.20000
OPPCIRCLE_USER_AGENTNoCustom User-Agent header.
OPPCIRCLE_MAX_CONTENT_CHARSNoMax body text returned by oppcircle_get.8000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
oppcircle_searchA

Search the Opportunities Circle catalog (scholarships, fellowships, internships, grants, jobs, competitions, online courses, training, conferences, exchange programs). This is the main discovery tool. Free-text query plus optional filters by opportunity type, country, funding, and free-form tags. By default EXPIRED opportunities are excluded and results are newest-first. Returns a formatted list; use the returned id (or URL) with oppcircle_get for full details. Tip: to discover valid type slugs use oppcircle_list_categories, and for country/funding/other tag slugs use oppcircle_list_tags.

oppcircle_getA

Fetch the full details of a single opportunity by numeric id, slug, or its public url. Returns the complete description (eligibility, benefits, how to apply, deadlines, official links) converted to readable text, plus its type, tags, country/funding tags, dates and featured image. Provide exactly one of id / slug / url.

oppcircle_latestA

Return the most recently posted (non-expired) opportunities, newest first. Optionally restrict to one type. A convenience shortcut over oppcircle_search for 'what's new'.

oppcircle_list_categoriesA

List the opportunity type categories with their slugs and how many opportunities each holds. Use these slugs as the type filter in oppcircle_search / oppcircle_latest. Optionally filter the list by a search term.

oppcircle_list_tagsA

Search the tag taxonomy (13k+ tags) to discover valid slugs for the country, funding, and tags filters of oppcircle_search. Tags encode countries (usa, europe, uk), funding (fully-funded, paid), study level (phd-scholarship, masters-scholarship), host organizations (un-program, fao) and deadline months. Provide a search term for best results; results are ordered by popularity.

oppcircle_overviewA

High-level snapshot of the Opportunities Circle catalog: site info, total active opportunities, and the breakdown of opportunity types by count. Good first call to understand what's available and which type slugs to use.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a distinct, non-overlapping purpose: search, retrieve details, latest, list categories, list tags, and overview. There is no ambiguity; even the convenience shortcut (latest) clearly references search without overlapping.

Naming Consistency5/5

All tools use the consistent 'oppcircle_' prefix followed by a clear action verb or noun, all in snake_case. The naming pattern is uniform and predictable (e.g., oppcircle_search, oppcircle_list_categories).

Tool Count5/5

Six tools is a well-scoped size for a read-only catalog server. Each tool earns its place: discovery (search, latest, overview), retrieval (get), and metadata (list categories, tags). No redundancy or excess.

Completeness5/5

The surface fully covers the apparent domain of browsing and retrieving opportunities from the catalog. Search with filters, detailed fetch, recent items, category and tag enumeration, and an overview cover all typical user workflows without missing critical operations.

Maintenance

ActivityMaintained
ResponsivenessNo issues