Open Medici Public Fellowship and Grant Search
Public fellowship and grant search with sourced details and live filter vocabularies.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~5,360Tokens (tool definitions)
~20.7 KBTypical response size
Significant attention impact (4.19% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"public": {
"url": "https://openmedici.com/mcp"
}
}
}Remote endpoints
https://openmedici.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (3)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_opportunities(query, type, topic, applicant, career, ...)
Search published public fellowships, grants, scholarships, prizes, and funded residencies. For matching, start with separate broad calls for the exact topic, synonyms, broader fields, and type-only grants and fellowships. Do not stack sparse topic, career, and location filters during initial discovery. Array values are OR alternatives within one filter; separate filter fields are combined with AND. Search results are candidates only: call get_opportunity before ranking or citing each one.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Short topic, program, or funder query. Use separate calls for useful synonyms and broader fields."
},
"type": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"types\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"topic": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"topics\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"applicant": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"applicants\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"career": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"careers\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"audience": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"audiences\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"education": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"education\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"enrollment": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"enrollments\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"citizenship": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"citizenships\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"residence": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"residences\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"country": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"countries\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"destination": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"destinations\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"benefit": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"benefits\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"fundingShape": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"fundingShapes\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"durationUnit": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Filter by the unit stored on duration facts; this does not change the day-based durationMin and durationMax fields."
},
"openState": {
"type": "array",
"items": {
"$ref": "#/properties/type/items"
},
"maxItems": 20,
"description": "Use exact values returned by list_filter_options with facet=\"openStates\". Multiple values are OR alternatives within this filter; different filter fields are combined with AND."
},
"lifecycle": {
"type": "array",
"items": {
"type": "string",
"enum": [
"active_accepting",
"active_between_cycles",
"active_no_applications",
"paused",
"ended",
"renamed_or_moved",
"inaccessible",
"unclear"
]
},
"maxItems": 8,
"description": "Use exact values returned by list_filter_options with facet=\"lifecycles\". Multiple values are OR alternatives; different filter fields are combined with AND."
},
"ageMin": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"ageMax": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"deadlineFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"deadlineTo": {
"$ref": "#/properties/deadlineFrom"
},
"rollingOnly": {
"type": "boolean"
},
"fundedOnly": {
"type": "boolean"
},
"fundingMin": {
"type": "number",
"minimum": 0,
"maximum": 1000000000
},
"fundingMax": {
"type": "number",
"minimum": 0,
"maximum": 1000000000
},
"durationMin": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"description": "Minimum opportunity duration in days."
},
"durationMax": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"description": "Maximum opportunity duration in days."
},
"openOnly": {
"type": "boolean"
},
"locale": {
"type": "string",
"enum": [
"en",
"es"
],
"default": "en"
},
"sort": {
"type": "string",
"enum": [
"rank",
"deadline",
"name",
"recent"
],
"default": "rank"
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 20
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"opportunities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"organization": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"pageAvailable": {
"type": "boolean"
}
},
"required": [
"id",
"slug",
"name",
"pageAvailable"
],
"additionalProperties": false
},
"type": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"eligibleCountries": {
"type": "array",
"items": {
"type": "string"
}
},
"destinationCountries": {
"type": "array",
"items": {
"type": "string"
}
},
"careerStages": {
"type": "array",
"items": {
"type": "string"
}
},
"fundingMinUsd": {
"type": [
"number",
"null"
]
},
"fundingMaxUsd": {
"type": [
"number",
"null"
]
},
"nextDeadline": {
"type": [
"string",
"null"
]
},
"lifecycle": {
"type": "string"
},
"recordUrl": {
"type": "string",
"format": "uri"
},
"officialUrl": {
"type": "string",
"format": "uri"
},
"sourceCheckedAt": {
"type": [
"string",
"null"
]
},
"ranking": {
"type": "object",
"properties": {
"position": {
"type": "integer",
"exclusiveMinimum": 0
},
"tier": {
"type": "string",
"enum": [
"S",
"A",
"B",
"Unscored"
]
},
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 100
},
{
"type": "null"
}
]
},
"badge": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
}
},
"required": [
"position",
"tier",
"score",
"badge",
"reason"
],
"additionalProperties": false
}
},
"required": [
"id",
"slug",
"name",
"organization",
"type",
"summary",
"fields",
"eligibleCountries",
"destinationCountries",
"careerStages",
"fundingMinUsd",
"fundingMaxUsd",
"nextDeadline",
"lifecycle",
"recordUrl",
"officialUrl",
"sourceCheckedAt",
"ranking"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"count": {
"type": "integer"
},
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"pages": {
"type": "integer"
},
"sort": {
"type": "string",
"enum": [
"rank",
"deadline",
"name",
"recent"
]
}
},
"required": [
"limit",
"offset",
"count",
"total",
"page",
"pages",
"sort"
],
"additionalProperties": false
}
},
"required": [
"opportunities",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_opportunity(slug, locale)
Get one published public opportunity, its current cycles, source records, and any approved eligibility or funding facts before ranking or citing it. Missing facts remain unknown. Open Medici ranking is a catalog signal, not personalized fit, eligibility, or acceptance likelihood.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"locale": {
"type": "string",
"enum": [
"en",
"es"
],
"default": "en"
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"opportunity": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"organization": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"pageAvailable": {
"type": "boolean"
}
},
"required": [
"id",
"slug",
"name",
"pageAvailable"
],
"additionalProperties": false
},
"type": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"eligibleCountries": {
"type": "array",
"items": {
"type": "string"
}
},
"destinationCountries": {
"type": "array",
"items": {
"type": "string"
}
},
"careerStages": {
"type": "array",
"items": {
"type": "string"
}
},
"fundingMinUsd": {
"type": [
"number",
"null"
]
},
"fundingMaxUsd": {
"type": [
"number",
"null"
]
},
"nextDeadline": {
"type": [
"string",
"null"
]
},
"lifecycle": {
"type": "string"
},
"recordUrl": {
"type": "string",
"format": "uri"
},
"officialUrl": {
"type": "string",
"format": "uri"
},
"sourceCheckedAt": {
"type": [
"string",
"null"
]
},
"ranking": {
"type": "object",
"properties": {
"position": {
"type": "integer",
"exclusiveMinimum": 0
},
"tier": {
"type": "string",
"enum": [
"S",
"A",
"B",
"Unscored"
]
},
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 100
},
{
"type": "null"
}
]
},
"badge": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
}
},
"required": [
"position",
"tier",
"score",
"badge",
"reason"
],
"additionalProperties": false
},
"description": {
"type": [
"string",
"null"
]
},
"cycles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"opensOn": {
"type": [
"string",
"null"
]
},
"deadlineOn": {
"type": [
"string",
"null"
]
},
"applicationUrl": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"id",
"label",
"opensOn",
"deadlineOn",
"applicationUrl",
"status"
],
"additionalProperties": false
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"title": {
"type": [
"string",
"null"
]
},
"publisher": {
"type": [
"string",
"null"
]
},
"publishedOn": {
"type": [
"string",
"null"
]
},
"retrievedAt": {
"type": "string"
},
"sourceCheckedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"url",
"title",
"publisher",
"publishedOn",
"retrievedAt",
"sourceCheckedAt"
],
"additionalProperties": false
}
},
"opportunityFacts": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"precision": {
"type": "string",
"enum": [
"exact",
"estimated",
"derived"
]
},
"validity": {
"type": "object",
"properties": {
"from": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"through": {
"anyOf": [
{
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity/properties/from/anyOf/0"
},
{
"type": "null"
}
]
}
},
"required": [
"from",
"through"
],
"additionalProperties": false
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"freshThrough": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"locator": {
"type": "string"
},
"lastCheckedAt": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
}
},
"required": [
"url",
"locator",
"lastCheckedAt"
],
"additionalProperties": false
},
"minItems": 1
},
"kind": {
"type": "string",
"const": "funding"
},
"value": {
"type": "object",
"properties": {
"amountShape": {
"type": "string",
"enum": [
"exact",
"minimum",
"maximum",
"range",
"estimated"
]
},
"currencyCode": {
"type": "string"
},
"amount": {
"type": "string",
"pattern": "^-?\\d+(?:\\.\\d+)?$",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"amountMin": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"amountMax": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"scope": {
"type": "string",
"enum": [
"per_recipient",
"per_project",
"cohort",
"total_pool"
]
},
"usdAmount": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"usdAmountMin": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"usdAmountMax": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"usdConversionRate": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"usdConvertedOn": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity/properties/from/anyOf/0"
}
},
"additionalProperties": false
}
},
"required": [
"key",
"precision",
"validity",
"checkedAt",
"freshThrough",
"evidence",
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"key": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/key"
},
"precision": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/precision"
},
"validity": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity"
},
"checkedAt": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"freshThrough": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"evidence": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/evidence"
},
"kind": {
"type": "string",
"const": "benefit"
},
"value": {
"type": "object",
"properties": {
"benefitKind": {
"type": "string",
"enum": [
"stipend",
"salary",
"tuition",
"travel",
"housing",
"insurance",
"research_budget",
"in_kind"
]
},
"text": {
"type": "string"
}
},
"additionalProperties": false
}
},
"required": [
"key",
"precision",
"validity",
"checkedAt",
"freshThrough",
"evidence",
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"key": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/key"
},
"precision": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/precision"
},
"validity": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity"
},
"checkedAt": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"freshThrough": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"evidence": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/evidence"
},
"kind": {
"type": "string",
"const": "duration"
},
"value": {
"type": "object",
"properties": {
"number": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"minimum": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"maximum": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/value/properties/amount",
"description": "A base-10 decimal serialized as a string to preserve precision."
},
"unit": {
"type": "string",
"enum": [
"days",
"weeks",
"months",
"years",
"people",
"applications",
"percent"
]
}
},
"additionalProperties": false
}
},
"required": [
"key",
"precision",
"validity",
"checkedAt",
"freshThrough",
"evidence",
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"key": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/key"
},
"precision": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/precision"
},
"validity": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity"
},
"checkedAt": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"freshThrough": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"evidence": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/evidence"
},
"kind": {
"type": "string",
"const": "milestone"
},
"value": {
"type": "object",
"properties": {
"date": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity/properties/from/anyOf/0"
}
},
"additionalProperties": false
}
},
"required": [
"key",
"precision",
"validity",
"checkedAt",
"freshThrough",
"evidence",
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"key": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/key"
},
"precision": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/precision"
},
"validity": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity"
},
"checkedAt": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"freshThrough": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"evidence": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/evidence"
},
"kind": {
"type": "string",
"const": "statistic"
},
"value": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/2/properties/value"
}
},
"required": [
"key",
"precision",
"validity",
"checkedAt",
"freshThrough",
"evidence",
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"key": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/key"
},
"precision": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/precision"
},
"validity": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/validity"
},
"checkedAt": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"freshThrough": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/checkedAt"
},
"evidence": {
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/0/properties/evidence"
},
"kind": {
"type": "string",
"const": "eligibility"
},
"value": {
"anyOf": [
{
"$ref": "#/properties/opportunity/properties/opportunityFacts/items/anyOf/2/properties/value"
},
{
"type": "object",
"properties": {
"text": {
"type": "string"
},
"codes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
]
}
},
"required": [
"key",
"precision",
"validity",
"checkedAt",
"freshThrough",
"evidence",
"kind",
"value"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"id",
"slug",
"name",
"organization",
"type",
"summary",
"fields",
"eligibleCountries",
"destinationCountries",
"careerStages",
"fundingMinUsd",
"fundingMaxUsd",
"nextDeadline",
"lifecycle",
"recordUrl",
"officialUrl",
"sourceCheckedAt",
"ranking",
"description",
"cycles",
"sources",
"opportunityFacts"
],
"additionalProperties": false
}
},
"required": [
"opportunity"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_filter_options(facet, q, limit, offset)
List current database-backed values for one public search facet. Use this before search_opportunities instead of guessing taxonomy terms. An empty facet or absent user value means public coverage is missing; it is not evidence that the user is ineligible, so do not turn it into a hard exclusion. Map filters to facets as follows: type→types, topic→topics, applicant→applicants, career→careers, audience→audiences, education→education, enrollment→enrollments, citizenship→citizenships, residence→residences, country→countries, destination→destinations, benefit→benefits, fundingShape→fundingShapes, durationUnit→durationUnits, openState→openStates, lifecycle→lifecycles.
Input Schema
{
"type": "object",
"properties": {
"facet": {
"type": "string",
"enum": [
"types",
"lifecycles",
"fields",
"countries",
"destinations",
"careers",
"topics",
"applicants",
"audiences",
"benefits",
"citizenships",
"residences",
"education",
"enrollments",
"fundingShapes",
"durationUnits",
"openStates"
],
"description": "Plural facet catalog name corresponding to a search filter; see this tool's description for the exact mapping."
},
"q": {
"type": "string",
"maxLength": 100
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"default": 0
}
},
"required": [
"facet"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"label": {
"type": "string"
},
"count": {
"type": "integer"
}
},
"required": [
"value",
"label",
"count"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"facet": {
"type": "string",
"enum": [
"types",
"lifecycles",
"fields",
"countries",
"destinations",
"careers",
"topics",
"applicants",
"audiences",
"benefits",
"citizenships",
"residences",
"education",
"enrollments",
"fundingShapes",
"durationUnits",
"openStates"
]
},
"q": {
"type": "string"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"count": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"facet",
"q",
"limit",
"offset",
"count",
"total"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence
Recent observations
verifiedversion not recorded3 tools
verifiedversion not recorded3 tools