Open Medici Public Fellowship and Grant Search
Public fellowship and grant search with sourced details and live filter vocabularies.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"public": {
"url": "https://openmedici.com/mcp"
}
}
}Puntos de conexión remotos
https://openmedici.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (3)
🟢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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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#"
}Comunidad
Evidencia