GlobalSource Partners MCP Server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['author_uuid'], 'properties': {'author_uuid': {'type': 'string', 'description': 'The stable UUID of the research author to read.\n\nUse an author_uuid returned by another research tool.\n'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['author_uuid', 'author_name', 'author_short_biography', 'author_biography_html', 'author_profile_url', 'author_sectors'], 'properties': {'author_name': {'type': 'string', 'description': 'The display name of the research author.'}, 'author_uuid': {'type': 'string', 'description': 'The stable UUID of the research author.'}, 'author_sectors': {'type': 'array', 'items': {'required': ['sector_uuid', 'sector_name'], 'properties': {'sector_name': {'type': 'string', 'description': 'The display name of the research sector.'}, 'sector_uuid': {'type': 'string', 'description': 'The stable UUID of the research sector.'}}}, 'description': 'The visible sectors associated with this research author.'}, 'author_profile_url': {'type': 'string', 'description': "The URL where this research author's profile can be viewed."}, 'author_biography_html': {'type': ['string', 'null'], 'description': "The research author's biography as HTML, if available."}, 'author_short_biography': {'type': ['string', 'null'], 'description': 'A short biography or role summary for the research author, if available.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['post_uuid'], 'properties': {'post_uuid': {'type': 'string', 'description': 'The stable UUID of the research post to read.\n\nUse a post_uuid returned by search_research_posts.\n'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['post_uuid', 'post_title', 'post_type', 'post_published', 'post_updated', 'post_authors', 'post_sectors', 'post_body_html', 'post_url', 'post_snippet_notice'], 'properties': {'post_url': {'type': 'string', 'description': "The URL where this research post can be viewed. This may be a full post URL or teaser URL depending on the MCP user's permissions."}, 'post_type': {'type': 'string', 'description': "The type of research post, e.g., 'Report', 'In Brief', 'Presentation', etc."}, 'post_uuid': {'type': 'string', 'description': 'The stable UUID of the research post.'}, 'post_title': {'type': 'string', 'description': 'The title of the research post.'}, 'post_authors': {'type': 'array', 'items': {'required': ['author_uuid', 'author_name'], 'properties': {'author_name': {'type': 'string', 'description': 'The display name of the research author.'}, 'author_uuid': {'type': 'string', 'description': 'The stable UUID of the research author.'}}}, 'description': 'The authors of this research post.'}, 'post_sectors': {'type': 'array', 'items': {'required': ['sector_uuid', 'sector_name'], 'properties': {'sector_name': {'type': 'string', 'description': 'The display name of the research sector.'}, 'sector_uuid': {'type': 'string', 'description': 'The stable UUID of the research sector.'}}}, 'description': 'The sectors associated with this research post. Only clients who are permissioned for these sectors can access the full version of this post; other clients will receive teaser content.\n'}, 'post_updated': {'type': 'string', 'description': 'The most recent update timestamp of the research post in ISO 8601 format.'}, 'post_body_html': {'type': 'string', 'description': "The HTML body available for this research post. This may be full post content or teaser content depending on the MCP user's permissions."}, 'post_published': {'type': 'string', 'description': 'The publication timestamp of the research post in ISO 8601 format.'}, 'post_snippet_notice': {'type': ['string', 'null'], 'description': 'A notice shown when the returned body contains only teaser or snippet content instead of the full research post. Null when the MCP user can view the full post.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'Maximum number of results to return. Minimum 1, maximum 50, default 10.'}, 'query': {'type': 'string', 'description': 'The entity name or approximate entity reference to search for.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['queried_name', 'limit', 'total_results_count', 'results'], 'properties': {'limit': {'type': 'integer', 'description': 'The maximum number of matching research entities requested.'}, 'results': {'type': 'array', 'items': {'required': ['entity_uuid', 'entity_name', 'entity_normalized_name', 'entity_description', 'available_research_count', 'match_confidence', 'match_type', 'matched_normalized_name', 'reason'], 'properties': {'reason': {'type': 'string', 'description': 'A short human-readable explanation of why this research entity was returned.'}, 'match_type': {'enum': ['normalized_name', 'alias'], 'type': 'string', 'description': 'How the research entity matched the query. Values are normalized_name or alias.'}, 'entity_name': {'type': 'string', 'description': 'The display name of the research entity.'}, 'entity_uuid': {'type': 'string', 'description': 'The stable UUID of the research entity.'}, 'match_confidence': {'type': 'number', 'description': 'A relative confidence score from 0.0 to 1.0 used to rank results. Scores should not be interpreted as probabilities.'}, 'entity_description': {'type': ['string', 'null'], 'description': 'A short description of the research entity, if available.'}, 'entity_normalized_name': {'type': 'string', 'description': 'The normalized name of the research entity, used for matching and deduplication.'}, 'matched_normalized_name': {'type': 'string', 'description': 'The normalized name or alias value that matched the query.'}, 'available_research_count': {'type': 'integer', 'description': 'The number of published research posts associated with this research entity.'}}}, 'description': 'The matching research entities, ordered by match confidence.'}, 'queried_name': {'type': 'string', 'description': 'The normalized version of the query used to search for research entities.'}, 'total_results_count': {'type': 'integer', 'description': 'The total number of matching research entities found before applying the result limit.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['research_entity_uuids'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of posts to return. Minimum 1, maximum 50, default 25.'}, 'order': {'enum': ['published_descending', 'published_ascending'], 'type': 'string', 'description': "Sort results by publication time. Use 'published_descending' for newest first or 'published_ascending' for oldest first. Default is published_descending."}, 'cursor': {'type': 'string', 'description': 'Pagination cursor returned by a previous response. Use this to retrieve the next page of results.'}, 'published_after': {'type': 'string', 'format': 'date-time', 'description': 'Only return posts published after this timestamp. Provide a complete RFC 3339 timestamp including a timezone, for example 2026-08-01T00:00:00Z. Date-only values such as 2026-08-01 are not accepted.'}, 'published_before': {'type': 'string', 'format': 'date-time', 'description': 'Only return posts published before this timestamp. Provide a complete RFC 3339 timestamp including a timezone, for example 2026-08-01T00:00:00Z. Date-only values such as 2026-08-01 are not accepted.'}, 'count_total_results': {'type': 'boolean', 'description': 'Whether to include the total number of matching posts. Use false unless the total count is specifically needed. Calculating the total count may increase response time for large result sets.'}, 'research_entity_uuids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'One or more research entity UUIDs to search against.\n\nThis field is required.\n\nAt least one research entity UUID must be supplied.\n\nDo not pass entity names.\n\nIf the user provides entity names rather than UUIDs, first call the "search_research_entities" tool and use the returned UUIDs from that tool.\n'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['research_entities', 'published_before', 'published_after', 'order', 'limit', 'next_cursor', 'total_results_count', 'results'], 'properties': {'limit': {'type': 'integer', 'description': 'The maximum number of research posts requested.'}, 'order': {'type': 'string', 'description': 'The sort order applied to the results.'}, 'results': {'type': 'array', 'items': {'required': ['post_uuid', 'post_title', 'post_type', 'post_published', 'post_updated', 'matched_research_entities', 'post_authors', 'post_sectors', 'post_snippet'], 'properties': {'post_type': {'type': 'string', 'description': "The type of research post, e.g., 'Report', 'In Brief', 'Presentation', etc."}, 'post_uuid': {'type': 'string', 'description': 'The stable UUID of the research post.'}, 'post_title': {'type': 'string', 'description': 'The title of the research post.'}, 'post_authors': {'type': 'array', 'items': {'required': ['author_uuid', 'author_name'], 'properties': {'author_name': {'type': 'string', 'description': 'The display name of the research author.'}, 'author_uuid': {'type': 'string', 'description': 'The stable UUID of the research author.'}}}, 'description': 'The authors of this research post.'}, 'post_sectors': {'type': 'array', 'items': {'required': ['sector_uuid', 'sector_name'], 'properties': {'sector_name': {'type': 'string', 'description': 'The display name of the research sector.'}, 'sector_uuid': {'type': 'string', 'description': 'The stable UUID of the research sector.'}}}, 'description': 'The sectors associated with this research post. Only clients who are  permissioned for these sectors can access the full version of this post;  other clients will only be able to see a snippet of the post and  will not have access to the full content.\n'}, 'post_snippet': {'type': 'string', 'description': 'A preview of this research post, which may be a human-written synopsis or a truncated excerpt from the research body.'}, 'post_updated': {'type': 'string', 'description': 'The most recent update timestamp of the research post in ISO 8601 format.'}, 'post_published': {'type': 'string', 'description': 'The publication timestamp of the research post in ISO 8601 format.'}, 'matched_research_entities': {'type': 'array', 'items': {'required': ['entity_uuid', 'entity_name', 'entity_normalized_name', 'entity_description'], 'properties': {'entity_name': {'type': 'string', 'description': 'The display name of the research entity.'}, 'entity_uuid': {'type': 'string', 'description': 'The stable UUID of the research entity.'}, 'entity_description': {'type': ['string', 'null'], 'description': 'A short description of the research entity, if available.'}, 'entity_normalized_name': {'type': 'string', 'description': 'The normalized name of the research entity, used for matching and deduplication.'}}}, 'description': 'The subset of the requested research entities that caused this post to be returned. This is most useful when searching using multiple research entities.\n'}}}, 'description': 'The research posts matching the supplied research entities and filters, ordered according to the requested sort order.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'An opaque pagination cursor. Supply this value in a subsequent request to retrieve the next page of results. Clients should not attempt to interpret or modify the cursor value. If this field is null, there are no additional pages of results.'}, 'published_after': {'type': 'string', 'description': 'The effective lower publication timestamp used for the search. If no lower publication date filter was supplied, this defaults to the earliest date from which research is available.'}, 'published_before': {'type': 'string', 'description': 'The effective upper publication timestamp used for the search. If no upper publication date filter was supplied, this defaults to the current date and time.'}, 'research_entities': {'type': 'array', 'items': {'required': ['entity_uuid', 'entity_name', 'entity_normalized_name', 'entity_description'], 'properties': {'entity_name': {'type': 'string', 'description': 'The display name of the research entity.'}, 'entity_uuid': {'type': 'string', 'description': 'The stable UUID of the research entity.'}, 'entity_description': {'type': ['string', 'null'], 'description': 'A short description of the research entity, if available.'}, 'entity_normalized_name': {'type': 'string', 'description': 'The normalized name of the research entity, used for matching and deduplication.'}}}, 'description': 'The research entities used to filter the search results.'}, 'total_results_count': {'type': ['integer', 'null'], 'description': 'The total number of matching research posts before pagination was applied. Returned only when count_total_results was requested with true; otherwise null.'}}}