com.mcparmory/perigon
PYPI · MCPARMORY-PERIGON · 2 COMPONENTS · SCANNED SEP 20
Search real-time news articles, companies, journalists, and trending topics
Available components
0 this week
72 72 Trust /100
Trust breakdown (7 categories)
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Install-script risk not yet assessed.Unverified
- 2 of 41 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (MIT License) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 130 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability57
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 10986 tokens (~784/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management80
- Stability observed for 24 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 14 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Install
How do I install the com.mcparmory/perigon MCP server?
com.mcparmory/perigon runs locally as a PyPI package, launched with uvx mcparmory-perigon. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · mcparmory-perigon
# add to Claude Code
claude mcp add com-mcparmory-perigon -- uvx mcparmory-perigon
// .cursor/mcp.json
{
"mcpServers": {
"com-mcparmory-perigon": {
"command": "uvx",
"args": [
"mcparmory-perigon"
]
}
}
} // .vscode/mcp.json
{
"servers": {
"com-mcparmory-perigon": {
"command": "uvx",
"args": [
"mcparmory-perigon"
]
}
}
} # add to Codex CLI
codex mcp add com-mcparmory-perigon -- uvx mcparmory-perigon
// opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-mcparmory-perigon": {
"type": "local",
"command": [
"uvx",
"mcparmory-perigon"
],
"enabled": true
}
}
} # add to OpenClaw
openclaw mcp add com-mcparmory-perigon --command uvx --arg mcparmory-perigon
# ~/.hermes/config.yaml
mcp_servers:
com-mcparmory-perigon:
command: "uvx"
args: ["mcparmory-perigon"] // ~/.netclaw/config/netclaw.json
{
"McpServers": {
"com-mcparmory-perigon": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"mcparmory-perigon"
]
}
}
} # add to Vellum
assistant mcp add com-mcparmory-perigon -t stdio -c uvx -a mcparmory-perigon
// mcp.json
{
"mcpServers": {
"com-mcparmory-perigon": {
"command": "uvx",
"args": [
"mcparmory-perigon"
]
}
}
} Changelog
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 19 Sept 26 −3
- Stability: pass → 0.77 functional
- 18 Sept 26 +1
- Stability: 0.97 → pass security
- 17 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- 16 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 14 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- 12 Sept 26 +12
- Malware scan: unverified → pass ▲ security
- Stability: pass → 0.80 functional
Diagnostics
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/mcparmory-perigon@1.0.3
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Dependencies 41 packages
| Packages resolved | 41 |
|---|---|
| Stale | 1 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
MCP tools
· 14 exposed
· ~10,986 tokens
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
Tool
Tokens
get_journalist Get Journalist ~69
Retrieve detailed information about a specific journalist using their unique identifier. Use this to access journalist profiles and biographical details referenced in article responses.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the journalist. This ID is provided in article response objects and is used to fetch the journalist's full profile. |
No output schema declared.
No examples provided.
get_story_counts_by_time_interval Get Story Counts by Time Interval ~1,220
Retrieve aggregated story count statistics grouped by specified time intervals (hour, day, week, or month). Supports comprehensive filtering by story attributes, entities, sentiment, and geographic location to analyze news trends and story evolution over time.
| Name | Type | Req | Description |
|---|---|---|---|
| category | array | – | Filter stories by broad content categories (e.g., Politics, Tech, Sports, Business, Finance). Use 'none' to find uncategorized stories. Multiple categories are combined with OR logic. |
| city | array | – | Filter local news by city. When applied, only local news from specified cities is returned; non-local news is excluded. Multiple cities are combined with OR logic. |
| clusterId | array | – | Filter results to include only stories with specific cluster IDs. Multiple IDs are combined with OR logic, returning stories matching any of the provided identifiers. |
| companyDomain | array | – | Filter stories by domains of prominently mentioned companies (e.g., apple.com). Multiple domains are combined with OR logic. Refer to the /companies endpoint for available options. |
| companyId | array | – | Filter stories by company identifiers of prominently mentioned companies. Multiple IDs are combined with OR logic. Refer to the /companies endpoint for available companies. |
| companySymbol | array | – | Filter stories by stock symbols of prominently mentioned companies. Multiple symbols are combined with OR logic. Refer to the /companies endpoint for available symbols. |
| country | array | – | Filter stories by country using ISO country codes. Multiple countries are combined with OR logic. |
| excludeClusterId | array | – | Exclude stories by their cluster IDs. Multiple IDs are combined with OR logic, filtering out stories matching any of the provided identifiers. |
| maxClusterSize | string | – | Filter stories by maximum cluster size based on unique article count. |
| minClusterSize | string | – | Filter stories by minimum cluster size based on unique article count. Minimum value is 1. |
| minUniqueSources | string | – | Require stories to be covered by a minimum number of unique sources. Higher values return more significant stories with broader coverage. Minimum value is 1; defaults to 3. |
| name | string | – | Search for stories by name using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcard patterns (* and ?) for flexible name matching. |
| nameExists | boolean | – | Include only stories that have been assigned names. Stories receive names after accumulating at least 5 unique articles. Defaults to true. |
| negativeSentimentFrom | number | – | Filter stories with aggregate negative sentiment score at or above the specified threshold. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| negativeSentimentTo | number | – | Filter stories with aggregate negative sentiment score at or below the specified threshold. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| neutralSentimentFrom | number | – | Filter stories with aggregate neutral sentiment score at or above the specified threshold. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| neutralSentimentTo | number | – | Filter stories with aggregate neutral sentiment score at or below the specified threshold. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| page | string | – | Specify which page of results to retrieve in the paginated response, starting from page 0. Maximum page number is 10,000. |
| personWikidataId | array | – | Filter stories by Wikidata IDs of prominently mentioned people. Multiple IDs are combined with OR logic. Refer to the /people endpoint for available individuals. |
| positiveSentimentFrom | number | – | Filter stories with aggregate positive sentiment score at or above the specified threshold. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| positiveSentimentTo | number | – | Filter stories with aggregate positive sentiment score at or below the specified threshold. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| size | string | – | Set the number of results per page. Must be between 0 and 100 results per page. |
| sortBy | string | – | Sort results by story creation date (default), last update date (best for tracking developing stories), relevance to query, unique article count, or total article count including reprints. |
| source | array | – | Filter stories containing articles from specific publisher domains or subdomains. Supports wildcard patterns (* and ?) for flexible matching. A story matches if it contains at least one article from… |
| sourceGroup | array | – | Filter stories containing articles from publishers in Perigon's curated source bundles (e.g., top100, top25crypto). A story matches if it contains at least one article from any publisher in the speci… |
| splitBy | string | yes | Required. Specify the time interval for grouping story count statistics: HOUR (hourly breakdown), DAY (daily breakdown), WEEK (weekly breakdown), MONTH (monthly breakdown), or NONE (no time-based gro… |
| state | array | – | Filter local news by state. When applied, only local news from specified states is returned; non-local news is excluded. Multiple states are combined with OR logic. |
| taxonomy | array | – | Filter stories by Google Content Categories using full hierarchical paths (e.g., /Finance/Banking/Other). Multiple paths are combined with OR logic. |
| topic | array | – | Filter stories by specific topics (e.g., Markets, Crime, Cryptocurrency, College Sports). Multiple topics are combined with OR logic. Consult the /topics endpoint for available options. |
| updatedFrom | string | – | Filter for stories that received new articles on or after this date (ISO 8601 format). Useful for tracking recently developing news events. |
| updatedTo | string | – | Filter for stories that received new articles on or before this date (ISO 8601 format). Useful for tracking recently developing news events. |
No output schema declared.
No examples provided.
list_story_history List Story History ~216
Retrieve a paginated list of story history records with optional filtering by cluster, sorting, and changelog status. Use this to track story creation and refresh events across your clusters.
| Name | Type | Req | Description |
|---|---|---|---|
| changelogExists | boolean | – | Filter to include only clusters that have a changelog (true) or exclude clusters with changelogs (false). Omit to return all clusters regardless of changelog status. |
| clusterId | array | – | Filter results to specific clusters by providing one or more cluster IDs. Only stories within the specified clusters will be returned. |
| page | string | – | Zero-based page number for pagination, ranging from 0 to 10000. Use this to navigate through large result sets. |
| size | string | – | Number of story results to return per page, ranging from 0 to 100. Larger values reduce the number of requests needed but increase response size. |
| sortBy | string | – | Sort results by creation date or the date the story was last refreshed/triggered. Defaults to creation date if not specified. |
No output schema declared.
No examples provided.
search_and_summarize_articles Search and Summarize Articles ~2,810
Generate a single, concise summary synthesizing insights from articles matching your search filters and criteria. Use custom prompts to guide which themes and findings to highlight in the summary.
| Name | Type | Req | Description |
|---|---|---|---|
| addDateFrom | string | – | Filter for articles added to the system after this date. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format. |
| addDateTo | string | – | Filter for articles added to the system before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format. |
| articleId | array | – | Retrieve specific articles by their unique identifiers. Provide one or more article IDs to return a targeted collection. |
| author | array | – | Filter articles by specific author names using exact matching. Multiple values create an OR filter to find articles by any specified author. |
| category | array | – | Filter by general article categories (e.g., Tech, Politics). Use 'none' to search uncategorized articles. Multiple values create an OR filter. |
| city | array | – | Filter articles where a specified city plays a central role in the content. Multiple values create an OR filter. |
| clusterId | array | – | Filter results to articles within a specific related content cluster. Returns articles grouped by topic relevance as Perigon Stories. |
| companyDomain | array | – | Filter articles by company domains (e.g., apple.com). Consult the /companies endpoint for available entities. Multiple values create an OR filter. |
| companyId | array | – | Filter articles by company identifiers. Refer to the /companies endpoint for tracked companies. Multiple values create an OR filter. |
| companySymbol | array | – | Filter articles by company stock symbols (ticker symbols). Consult the /companies endpoint for available symbols. Multiple values create an OR filter. |
| content | string | – | Search full article body content using Boolean logic, exact phrase matching with quotes, and wildcards for comprehensive searching. |
| country | array | – | Filter articles by country code. Multiple values create an OR filter. |
| county | array | – | Filter articles by county. Only articles tagged with one of these counties will be included. Multiple values create an OR filter. |
| desc | string | – | Search article descriptions using Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching. |
| excludeAuthor | array | – | Exclude articles written by specific authors using exact name matching. Multiple values create an AND-exclude filter. |
| excludeCategory | array | – | Exclude articles with specific categories. Multiple values create an AND-exclude filter. |
| excludeCity | array | – | Exclude articles associated with specified cities. Multiple values create an AND-exclude filter. |
| excludeCompanyDomain | array | – | Exclude articles related to companies with specific domains. Multiple values create an AND-exclude filter. |
| excludeCompanyId | array | – | Exclude articles mentioning companies with specific identifiers. Multiple values create an AND-exclude filter. |
| excludeCompanySymbol | array | – | Exclude articles related to companies with specific stock symbols. Multiple values create an AND-exclude filter. |
| excludeCounty | array | – | Exclude articles from specific counties or administrative divisions. County names should match the format used in article metadata (e.g., 'Los Angeles County', 'Cook County'). Multiple values create… |
| excludeJournalistId | array | – | Exclude articles written by specific journalists identified by their unique IDs. Multiple values create an AND-exclude filter. |
| excludeLabel | array | – | Exclude articles with specific editorial labels. Multiple values create an AND-exclude filter. |
| excludeLanguage | array | – | Exclude articles in specific languages using ISO 639 two-letter codes. Multiple values create an AND-exclude filter. |
| excludePersonName | array | – | Exclude articles mentioning specific people by name. Multiple values create an AND-exclude filter. |
| excludePersonWikidataId | array | – | Exclude articles mentioning people with specific Wikidata IDs. Multiple values create an AND-exclude filter. |
| excludeSource | array | – | Exclude articles from specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching. Multiple values create an AND-exclude filter. |
| excludeSourceCity | array | – | Exclude articles published by sources located within specified cities. Multiple values create an AND-exclude filter. |
| excludeSourceCountry | array | – | Exclude articles published by sources located within specified countries. Use 2-character country codes (e.g., us, gb). Multiple values create an AND-exclude filter. |
| excludeSourceCounty | array | – | Exclude articles published by sources located within specified counties. Multiple values create an AND-exclude filter. |
| excludeSourceGroup | array | – | Exclude articles from specified Perigon source groups. Multiple values create an AND-exclude filter, removing content from any matching bundle. |
| excludeSourceState | array | – | Exclude articles published by sources located within specified states. Multiple values create an AND-exclude filter. |
| excludeState | array | – | Exclude articles associated with specified states. Multiple values create an AND-exclude filter. |
| excludeTopic | array | – | Exclude articles with specific topics. Multiple values create an AND-exclude filter. |
| excludeWatchlist | array | – | Exclude articles mentioning entities from specified watchlists. Multiple values create an AND-exclude filter, removing content about any matching entity. |
| journalistId | array | – | Filter articles by unique journalist identifiers (available via the Journalist API or matchedAuthors field). Multiple values create an OR filter. |
| label | array | – | Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. Multiple values create an OR filter. |
| language | array | – | Filter articles by language using ISO 639 two-letter codes (e.g., en, es, fr). Multiple values create an OR filter. |
| lat | number | – | Latitude of the center point for geographic search. Range: -90 to 90 degrees. |
| linkTo | string | – | Return only articles containing links to the specified URL pattern. |
| location | array | – | Return articles with specified location attributes. Format: 'city:New York::state:NY' with ':' between key and value, '::' between attributes. |
| lon | number | – | Longitude of the center point for geographic search. Range: -180 to 180 degrees. |
| maxArticleCount | string | – | Maximum number of articles to factor into the summary. Range: 1–100 articles. Default: 10. |
| maxDistance | number | – | Maximum distance in kilometers from the center point for geographic search. Range: 1–300 km. |
| maxTokens | string | – | Maximum number of tokens to generate in the summary. Default: 2,048 tokens. |
| medium | array | – | Filter by content medium: Article (written content) or Video (video-based stories). Multiple values create an OR filter. |
| method | string | – | Method for selecting articles: ARTICLES (include all matches) or CLUSTERS (one article per cluster). Default: ARTICLES. |
| model | string | – | Underlying LLM model for generation. Options: gpt-4o, gpt-4o-mini, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano, llama-3.3-70b-versatile, openai/gpt-oss-120b. Default: gpt-4.1. |
| negativeSentimentFrom | number | – | Filter articles with negative sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| negativeSentimentTo | number | – | Filter articles with negative sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| neutralSentimentFrom | number | – | Filter articles with neutral sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| neutralSentimentTo | number | – | Filter articles with neutral sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| page | string | – | Specify which page of results to retrieve, starting from page 0. Supports up to 10,000 pages. |
| paywall | boolean | – | Filter by paywall status: true for sources with paywalls, false for sources without paywalls. |
| personWikidataId | array | – | Filter articles by Wikidata IDs of mentioned people. Refer to the /people endpoint for tracked individuals. Multiple values create an OR filter. |
| positiveSentimentFrom | number | – | Filter articles with positive sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| positiveSentimentTo | number | – | Filter articles with positive sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| prefixTaxonomy | string | – | Filter by Google Content Categories using category prefix only (e.g., /Finance). Matches all categories starting with the specified prefix. |
| prompt | string | – | Custom instructions guiding how the summary should be written. Maximum 2,048 characters. Defaults to a casual, natural tone synthesis in one paragraph (no more than 125 words). |
| refreshDateFrom | string | – | Filter for articles refreshed or updated in the system after this date. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format. |
| refreshDateTo | string | – | Filter for articles refreshed or updated in the system before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format. |
| reprintGroupId | string | – | Return all articles in a specific reprint group, including the original article and all known reprints. |
| returnedArticleCount | string | – | Maximum number of articles to return in the response. Can be less than maxArticleCount. Range: 1–100 articles. Default: 10. |
| searchTranslation | boolean | – | When true, expands search to include translated title, description, and content fields for non-English articles. |
| showReprints | boolean | – | When true (default), includes reprinted content from wire services like AP or Reuters that appear on multiple sites. |
| size | string | – | Number of articles to return per page. Range: 0–1,000 articles. |
| sortBy | string | – | Determine article sort order: relevance (default), date/pubDate (newest first), reverseDate (oldest first), addDate (newest ingestion first), reverseAddDate (oldest ingestion first), or refreshDate (… |
| source | array | – | Filter by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching. Multiple values create an OR filter. |
| sourceCity | array | – | Filter articles published by sources located within specified cities. Multiple values create an OR filter. |
| sourceCountry | array | – | Filter articles published by sources located within specified countries. Use 2-character country codes (e.g., us, gb). Multiple values create an OR filter. |
| sourceCounty | array | – | Filter articles published by sources located within specified counties. Multiple values create an OR filter. |
| sourceGroup | array | – | Filter using Perigon's curated publisher bundles (e.g., top100, top25crypto). Multiple values create an OR filter. |
| sourceState | array | – | Filter articles published by sources located within specified states. Multiple values create an OR filter. |
| state | array | – | Filter articles where a specified state plays a central role in the content. Multiple values create an OR filter. |
| summarizeFields | array | – | Which article fields to include when generating the summary. Choose up to three values from: TITLE, CONTENT, SUMMARY. Default: all three. |
| summary | string | – | Search article summary fields using Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching. |
| taxonomy | array | – | Filter by Google Content Categories using full category names (e.g., /Finance/Banking/Other, /Finance/Investing/Funds). Refer to the Google Content Categories documentation for the complete list. Mul… |
| temperature | number | – | Sampling temperature for the LLM controlling randomness. Range: 0.0 (deterministic) to 2.0 (very creative). Default: 0.7. |
| title | string | – | Search article titles using Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards for pattern matching. |
| topP | number | – | Nucleus sampling (top-p) parameter for the LLM controlling diversity. Range: 0.0 to 1.0. Default: 1.0. |
| topic | array | – | Filter by specific topics (e.g., Markets, Crime, Cryptocurrency, College Sports). Topics are more granular than categories. Multiple values create an OR filter. Consult the /topics endpoint for avail… |
| url | string | – | Search by URL patterns to filter articles from specific website sections or domains. |
| watchlist | array | – | Filter articles using watchlists of people and companies. Multiple values create an OR filter to include articles mentioning any entity from specified watchlists. |
No output schema declared.
No examples provided.
search_articles Search Articles ~2,517
Search and filter news articles across Perigon's database using flexible query parameters. Returns paginated results with support for text search, date ranges, geographic filters, entity mentions, sentiment analysis, and content categorization.
| Name | Type | Req | Description |
|---|---|---|---|
| addDateFrom | string | – | Filter for articles added to Perigon's system after this date. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or simple date format (yyyy-mm-dd). |
| addDateTo | string | – | Filter for articles added to Perigon's system before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or simple date format (yyyy-mm-dd). |
| articleId | array | – | Retrieve specific articles by their unique identifiers. Provide one or more article IDs to return a targeted collection. |
| author | array | – | Filter articles by specific author names using exact matching. Multiple values create an OR filter to find articles by any specified author. |
| category | array | – | Filter by general article categories (e.g., Tech, Politics). Use 'none' to search uncategorized articles. Multiple values create an OR filter. |
| city | array | – | Filter articles where a specified city plays a central role in the content, beyond mere mentions. Multiple values create an OR filter. |
| clusterId | array | – | Filter results to articles within a specific related content cluster. Returns articles grouped together as part of Perigon Stories based on topic relevance. |
| companyDomain | array | – | Filter articles by company domains (e.g., apple.com). Consult the /companies endpoint for available company entities. Multiple values create an OR filter. |
| companyId | array | – | Filter articles by company identifiers. Refer to the /companies endpoint for available tracked companies. Multiple values create an OR filter. |
| companySymbol | array | – | Filter articles by company stock symbols (ticker symbols). Consult the /companies endpoint for available symbols. Multiple values create an OR filter. |
| content | string | – | Search within the full article body content. Supports Boolean logic, exact phrase matching with quotes, and wildcards for comprehensive content searching. |
| country | array | – | Filter articles by country code. Multiple values create an OR filter. |
| county | array | – | Filter articles by specific counties. Only articles tagged with one of these counties will be included. |
| desc | string | – | Search within article description fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching. |
| excludeAuthor | array | – | Exclude articles written by specific authors. Any article with an author name matching an entry will be omitted. Multiple values create an AND-exclude filter. |
| excludeCategory | array | – | Exclude articles with specific categories. Multiple values create an AND-exclude filter, removing all content with any specified category. |
| excludeCity | array | – | Exclude articles associated with specified cities. Articles tagged with any specified city will be filtered out. |
| excludeCompanyDomain | array | – | Exclude articles related to companies with specific domains. Multiple values create an AND-exclude filter. |
| excludeCompanyId | array | – | Exclude articles mentioning companies with specific identifiers. Multiple values create an AND-exclude filter. |
| excludeCompanySymbol | array | – | Exclude articles related to companies with specific stock symbols. Multiple values create an AND-exclude filter. |
| excludeCounty | array | – | Exclude articles from specific counties or administrative divisions. County names should match the format used in article metadata (e.g., 'Los Angeles County', 'Cook County'). |
| excludeJournalistId | array | – | Exclude articles written by specific journalists identified by their unique IDs. Multiple values create an AND-exclude filter. |
| excludeLabel | array | – | Exclude articles with specific editorial labels. Multiple values create an AND-exclude filter, removing all content with any specified label. |
| excludeLanguage | array | – | Exclude articles in specific languages using ISO 639 two-letter codes. Multiple values create an AND-exclude filter. |
| excludePersonName | array | – | Exclude articles mentioning specific people by name. Multiple values create an AND-exclude filter. |
| excludePersonWikidataId | array | – | Exclude articles mentioning people with specific Wikidata IDs. Uses precise identifiers to avoid name ambiguity. Multiple values create an AND-exclude filter. |
| excludeSource | array | – | Exclude articles from specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching. Multiple values create an AND-exclude filter. |
| excludeSourceCity | array | – | Exclude articles published by sources located within specified cities. |
| excludeSourceCountry | array | – | Exclude articles published by sources located within specified countries. Use 2-character country codes (e.g., us, gb). |
| excludeSourceCounty | array | – | Exclude articles published by sources located within specified counties. |
| excludeSourceGroup | array | – | Exclude articles from specified Perigon source groups. Multiple values create an AND-exclude filter, removing content from publishers in any specified bundle. |
| excludeSourceState | array | – | Exclude articles published by sources located within specified states. |
| excludeState | array | – | Exclude articles associated with specified states. Articles tagged with any specified state will be filtered out. |
| excludeTopic | array | – | Exclude articles with specific topics. Multiple values create an AND-exclude filter, removing all content with any specified topic. |
| excludeWatchlist | array | – | Exclude articles mentioning entities from specified watchlists. Multiple values create an AND-exclude filter, removing content about any entity in the specified watchlists. |
| journalistId | array | – | Filter by unique journalist identifiers (available via the Journalist API or matchedAuthors field). Multiple values create an OR filter. |
| label | array | – | Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. Multiple values create an OR filter. |
| language | array | – | Filter articles by language using ISO 639 two-letter codes (e.g., en, es, fr). Multiple values create an OR filter. |
| lat | number | – | Latitude of the center point for geographic search. Must be between -90 and 90 degrees. |
| linkTo | string | – | Returns only articles that contain links to the specified URL pattern. Matches against the links field in article responses. |
| location | array | – | Return articles with specified location attributes. Location format uses ':' between key and value, and '::' between attributes (e.g., 'city:New York::state:NY'). |
| lon | number | – | Longitude of the center point for geographic search. Must be between -180 and 180 degrees. |
| maxDistance | number | – | Maximum distance in kilometers from the center point for geographic search. Must be between 1 and 300 km. |
| medium | array | – | Filter by content medium type. Choose Article for written content or Video for video-based stories. Multiple values create an OR filter. |
| negativeSentimentFrom | number | – | Filter articles with negative sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| negativeSentimentTo | number | – | Filter articles with negative sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| neutralSentimentFrom | number | – | Filter articles with neutral sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| neutralSentimentTo | number | – | Filter articles with neutral sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| page | string | – | The page number of results to retrieve in paginated responses. Starts at 0 and supports up to page 10000. |
| paywall | boolean | – | Filter by paywall status. Set to true to show only paywalled sources, or false to show only free sources. |
| personWikidataId | array | – | Filter articles by Wikidata IDs of mentioned people. Refer to the /people endpoint for available tracked individuals. Multiple values create an OR filter. |
| positiveSentimentFrom | number | – | Filter articles with positive sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| positiveSentimentTo | number | – | Filter articles with positive sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| prefixTaxonomy | string | – | Filter by Google Content Categories using category prefix only (e.g., /Finance). Matches all categories starting with the specified prefix. |
| refreshDateFrom | string | – | Filter for articles refreshed or updated in Perigon's system after this date. May differ from addDateFrom for updated content. Accepts ISO 8601 or simple date format. |
| refreshDateTo | string | – | Filter for articles refreshed or updated in Perigon's system before this date. May differ from addDateTo for updated content. Accepts ISO 8601 or simple date format. |
| reprintGroupId | string | – | Returns all articles in a specific reprint group, including the original article and all known reprints. Use to see all versions of the same content. |
| searchTranslation | boolean | – | Expand search to include translated content fields for non-English articles. When enabled, searches translated title, description, and content fields. |
| showReprints | boolean | – | Controls whether to include reprinted content in results. When true (default), shows syndicated articles from wire services like AP or Reuters that appear on multiple sites. |
| size | string | – | Number of articles to return per page. Accepts values from 0 to 1000. |
| sortBy | string | – | Determines result ordering. Choose from relevance (default), date/pubDate (newest first), reverseDate (oldest first), addDate (newest ingestion first), reverseAddDate (oldest ingestion first), or ref… |
| source | array | – | Filter by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an OR filter. |
| sourceCity | array | – | Find articles published by sources located within specified cities. |
| sourceCountry | array | – | Find articles published by sources located within specified countries. Use 2-character country codes (e.g., us, gb). |
| sourceCounty | array | – | Find articles published by sources located within specified counties. |
| sourceGroup | array | – | Filter using Perigon's curated publisher bundles (e.g., top100, top25crypto). Multiple values create an OR filter to include articles from any specified bundle. |
| sourceState | array | – | Find articles published by sources located within specified states. |
| state | array | – | Filter articles where a specified state plays a central role in the content, beyond mere mentions. Multiple values create an OR filter. |
| summary | string | – | Search within article summary fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching. |
| taxonomy | array | – | Filter by Google Content Categories using full category names (e.g., /Finance/Banking/Other, /Finance/Investing/Funds). Refer to Google's category list for complete options. Multiple values create an… |
| title | string | – | Search within article headlines and titles. Supports Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (*) for pattern variations. |
| topic | array | – | Filter by specific topics (e.g., Markets, Crime, Cryptocurrency, College Sports). Topics are more granular than categories and articles can have multiple topics. Multiple values create an OR filter. |
| url | string | – | Search query on the URL field. Useful for filtering articles from specific website sections or domains (e.g., source=cnn.com&url=travel). |
| watchlist | array | – | Filter articles using watchlists of people and companies. Multiple values create an OR filter to include articles mentioning any entity from specified watchlists. |
No output schema declared.
No examples provided.
search_companies Search Companies ~526
Search and filter companies tracked by Perigon using multiple criteria including name, domain, ticker symbol, industry, sector, and company metadata. Supports Boolean search logic for flexible querying across company attributes.
| Name | Type | Req | Description |
|---|---|---|---|
| country | array | – | Filter results to companies headquartered in specific countries. Accepts multiple countries as an OR filter. |
| domain | array | – | Filter results to companies with specific domain names or websites (e.g., apple.com, microsoft.com). Accepts multiple domains as an OR filter. |
| exchange | array | – | Filter results to companies listed on specific stock exchanges (e.g., NASDAQ, NYSE). Accepts multiple exchanges as an OR filter. |
| id | array | – | Filter results to companies with specific unique identifiers. Accepts multiple IDs as an OR filter (returns companies matching any ID in the list). |
| industry | string | – | Filter by company industry classifications using Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* for multiple characters, ? for single character). |
| ipoFrom | string | – | Filter for companies that went public on or after this date. Accepts ISO 8601 format (e.g., 2023-01-01T00:00:00) or yyyy-mm-dd format. |
| ipoTo | string | – | Filter for companies that went public on or before this date. Accepts ISO 8601 format (e.g., 2023-12-31T23:59:59) or yyyy-mm-dd format. |
| name | string | – | Search within company names using Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* for multiple characters, ? for single character). |
| numEmployeesFrom | string | – | Filter for companies with at least this minimum number of employees. Must be a positive integer. |
| numEmployeesTo | string | – | Filter for companies with no more than this maximum number of employees. Must be a positive integer. |
| page | string | – | Zero-indexed page number to retrieve from the paginated results. Must be 0 or greater. |
| sector | string | – | Filter by company sector classifications using Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* for multiple characters, ? for single character). |
| size | string | – | Number of companies to return per page. Must be between 1 and 100 inclusive. |
| symbol | array | – | Filter results to companies with specific stock ticker symbols (e.g., AAPL, MSFT). Accepts multiple symbols as an OR filter. |
No output schema declared.
No examples provided.
search_journalists Search Journalists ~470
Search and filter journalists from a global database of over 230,000 profiles. Use multiple filter criteria to find journalists by name, coverage topics, publication sources, and other attributes.
| Name | Type | Req | Description |
|---|---|---|---|
| category | array | – | Filter by general content categories journalists cover (e.g., 'Tech', 'Politics'). Matches any category in the list (OR operation). |
| country | array | – | Filter by countries journalists commonly cover. Use ISO 3166-1 alpha-2 country codes in lowercase (e.g., us, gb, jp). Matches any country in the list (OR operation). |
| id | array | – | Filter by one or more journalist IDs. Matches any journalist whose ID is in the provided list (OR operation). |
| label | array | – | Filter by article labels most commonly associated with journalists' work (e.g., 'Opinion', 'Pop Culture'). Matches any label in the list (OR operation). |
| name | string | – | Search journalist names using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (* and ?) for pattern matching. |
| page | string | – | Zero-indexed page number for pagination. Use 0 for the first page. |
| size | string | – | Number of results to return per page. Must be between 0 and 1,000. |
| source | array | – | Filter by publisher domains where journalists write. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Matches any domain in the list (OR operation). |
| topic | array | – | Filter by specific topics journalists cover (e.g., 'Economy', 'Real Estate', 'Cryptocurrency'). Matches any topic in the list (OR operation). |
| string | – | Filter by exact Twitter handle (without the @ symbol). | |
| updatedAtFrom | string | – | Filter for journalist profiles updated on or after this date. Accepts ISO 8601 format (e.g., 2023-03-01T00:00:00) or yyyy-mm-dd format. |
| updatedAtTo | string | – | Filter for journalist profiles updated on or before this date. Accepts ISO 8601 format (e.g., 2023-03-01T23:59:59) or yyyy-mm-dd format. |
No output schema declared.
No examples provided.
search_media_sources Search Media Sources ~618
Search and filter from 200,000+ media sources to find publishers matching your criteria. Results include detailed source information with flexible filtering by domain, geography, content focus, and publication characteristics.
| Name | Type | Req | Description |
|---|---|---|---|
| category | array | – | Filter sources by primary content categories (e.g., Politics, Tech, Sports, Business, Finance). Returns sources that frequently cover these topics. Multiple values use OR logic. |
| country | array | – | Filter sources by countries they frequently cover in reporting. Use ISO 3166-1 alpha-2 country codes (lowercase, e.g., us, gb, jp). Multiple values use OR logic. |
| domain | array | – | Filter by publisher domain or subdomain using wildcard patterns (* for any characters, ? for single character). Supports multiple domains with OR logic (e.g., *.cnn.com, us?.nytimes.com). |
| label | array | – | Filter sources by content label patterns (e.g., Opinion, Paid-news, Non-news). Returns sources where the label commonly appears in published content. Multiple values use OR logic. |
| name | string | – | Search source names using Boolean operators (AND, OR, NOT), quoted exact phrases, and wildcards (* and ?) for flexible matching. |
| page | string | – | Retrieve a specific page of results (0-indexed). Use with size parameter for pagination through large result sets. |
| paywall | boolean | – | Filter by paywall status: true for sources with paywalls, false for sources without paywalls. |
| showSubdomains | boolean | – | Control subdomain handling in results. When true (default), subdomains appear as separate sources. When false, results consolidate to parent domains only. |
| size | string | – | Number of sources per page (1-100). Adjust based on your needs; larger values reduce pagination requests but increase response size. |
| sortBy | string | – | Sort results by relevance to your query (default), overall traffic rank, monthly visitor count, or publication frequency. Choose the metric most relevant to your use case. |
| sourceCity | array | – | Filter for local publications based in specific cities. Multiple values use OR logic. |
| sourceCountry | array | – | Filter for local publications based in specific countries. Use ISO 3166-1 alpha-2 country codes (lowercase). Multiple values use OR logic. |
| sourceCounty | array | – | Filter for local publications based in specific counties. Multiple values use OR logic. |
| sourceGroup | string | – | Filter by predefined publisher bundles or collections (e.g., top100, top50tech). Returns all sources within the specified group. |
| sourceState | array | – | Filter for local publications based in specific states or regions. Use standard two-letter state codes (lowercase, e.g., ca, ny, tx). Multiple values use OR logic. |
| topic | array | – | Filter sources by frequently covered topics (e.g., Markets, Cryptocurrency, Climate Change). Returns sources where the topic ranks in their top 10 coverage areas. Multiple values use OR logic. |
No output schema declared.
No examples provided.
search_news_articles Search News Articles ~310
Search news articles from the past 6 months using natural language queries with semantic relevance matching. Returns a ranked list of articles most closely aligned with your search intent, with optional filtering by publication date and content type.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | Filter criteria to narrow search results (specific filter structure not documented). |
| page | string | – | Page number to retrieve for paginated results. Must be between 0 and 10000. Defaults to the first page (0). |
| prompt | string | yes | Natural language query describing what you want to find in news articles. Accepts up to 1024 characters. |
| pubDateFrom | string | – | Earliest publication date to include in results. Accepts ISO 8601 format (e.g., 2024-01-01T00:00:00Z) or simple date format (yyyy-mm-dd). Defaults to articles from the last 30 days if not specified. |
| pubDateTo | string | – | Latest publication date to include in results. Accepts ISO 8601 format (e.g., 2024-12-31T23:59:59Z) or simple date format (yyyy-mm-dd). |
| showReprints | boolean | – | Include or exclude reprinted articles (wire service content from sources like AP or Reuters that appear across multiple outlets). Defaults to including reprints. |
| size | string | – | Number of results to return per page. Must be between 1 and 100 articles. Defaults to 10. |
No output schema declared.
No examples provided.
search_people Search People ~262
Search and retrieve detailed information on known persons from Perigon's database of over 650,000 people worldwide. Results include Wikidata identifiers for cross-referencing additional biographical data.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | – | Search by person's full or partial name using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (* for multiple characters, ? for single character) for flexible name-… |
| occupationLabel | string | – | Search by occupation or profession (e.g., politician, actor, CEO, athlete) using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (* and ?) for flexible occupation-b… |
| page | string | – | Specify which page of results to retrieve in the paginated response, starting from page 0. Use with size parameter to navigate through large result sets. |
| size | string | – | Set the number of people to return per page, between 1 and 100 results. Combine with page parameter to control pagination through results. |
| wikidataId | array | – | Filter results by one or more Wikidata entity IDs (e.g., Q7747, Q937) to precisely identify specific individuals and eliminate name ambiguity. Multiple IDs are combined with OR logic. |
No output schema declared.
No examples provided.
search_stories Search Stories ~1,130
Search and filter news story clusters to track evolving narratives, monitor sentiment trends, and identify coverage patterns across global publishers. Returns structured story metadata including summaries, key entities, sentiment scores, and article counts.
| Name | Type | Req | Description |
|---|---|---|---|
| category | array | – | Filter stories by broad content categories (e.g., Politics, Tech, Sports, Business, Finance). Use 'none' to find uncategorized stories. Multiple values return stories matching any category (OR logic). |
| city | array | – | Filter local news by city. When applied, only local news from specified cities is returned; non-local news is excluded. Multiple values use OR logic. |
| clusterId | array | – | Filter results to specific stories by their unique cluster identifiers. Multiple values return stories matching any of the specified IDs (OR logic). |
| companyDomain | array | – | Filter stories by domains of prominently mentioned companies (e.g., apple.com). Returns stories where companies with these domains appear as key entities. Multiple values use OR logic. |
| companyId | array | – | Filter stories by company identifiers of prominently mentioned companies. Returns stories where these companies appear as key entities. Multiple values use OR logic. |
| companySymbol | array | – | Filter stories by stock symbols of prominently mentioned companies. Returns stories where companies with these symbols appear as key entities. Multiple values use OR logic. |
| country | array | – | Filter stories by country code. Multiple values return stories matching any country (OR logic). |
| excludeClusterId | array | – | Exclude specific stories from results by their unique cluster identifiers. Multiple values exclude stories matching any of the specified IDs. |
| maxClusterSize | string | – | Return only stories with at most this many unique articles. |
| minClusterSize | string | – | Return only stories with at least this many unique articles. Minimum value is 1. |
| minUniqueSources | string | – | Return only stories covered by at least this many unique sources. Higher values identify more significant stories with broader coverage. Minimum value is 1; defaults to 3. |
| name | string | – | Search story names using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (*) for pattern variations. |
| nameExists | boolean | – | Return only stories that have been assigned names. Stories receive names after accumulating at least 5 unique articles. Defaults to true. |
| negativeSentimentFrom | number | – | Filter stories with aggregate negative sentiment score at or above this threshold. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| negativeSentimentTo | number | – | Filter stories with aggregate negative sentiment score at or below this threshold. Scores range from 0 to 1, with higher values indicating stronger negative tone. |
| neutralSentimentFrom | number | – | Filter stories with aggregate neutral sentiment score at or above this threshold. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| neutralSentimentTo | number | – | Filter stories with aggregate neutral sentiment score at or below this threshold. Scores range from 0 to 1, with higher values indicating stronger neutral tone. |
| page | string | – | Retrieve a specific page of paginated results, starting from page 0. Maximum page value is 10,000. |
| personWikidataId | array | – | Filter stories by Wikidata IDs of prominently mentioned people. Returns stories where these individuals appear as key entities. Multiple values use OR logic. |
| positiveSentimentFrom | number | – | Filter stories with aggregate positive sentiment score at or above this threshold. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| positiveSentimentTo | number | – | Filter stories with aggregate positive sentiment score at or below this threshold. Scores range from 0 to 1, with higher values indicating stronger positive tone. |
| size | string | – | Number of stories to return per page. Must be between 0 and 100. |
| sortBy | string | – | Sort results by story creation date (default), last update time (best for tracking developing events), relevance to query, unique article count, or total article count including reprints. |
| source | array | – | Filter stories containing articles from specific publisher domains or subdomains. Supports wildcard patterns (* and ?) for flexible matching. A story matches if it contains at least one article from… |
| sourceGroup | array | – | Filter stories containing articles from publishers in Perigon's curated source bundles (e.g., top100, top25crypto). A story matches if it contains at least one article from any publisher in the speci… |
| state | array | – | Filter local news by state. When applied, only local news from specified states is returned; non-local news is excluded. Multiple values use OR logic. |
| taxonomy | array | – | Filter stories by Google Content Categories using full hierarchical paths (e.g., /Finance/Banking/Other). Multiple values return stories matching any taxonomy path (OR logic). |
| topic | array | – | Filter stories by granular topics (e.g., Markets, Crime, Cryptocurrency, College Sports). Stories can match multiple topics. Multiple values return stories matching any topic (OR logic). |
| updatedFrom | string | – | Return only stories that received new articles on or after this date (ISO 8601 format). Useful for tracking recently developing events. |
| updatedTo | string | – | Return only stories that received new articles on or before this date (ISO 8601 format). Useful for tracking recently developing events. |
No output schema declared.
No examples provided.
search_topics Search Topics ~169
Search and browse all available topics in the Perigon database, with filtering by name, category, and subcategory. Results are paginated for efficient data retrieval.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Filter results to a specific broad category such as Politics, Tech, Sports, Business, Finance, or Entertainment. |
| name | string | – | Filter topics by exact name match or partial text search. Supports partial matching but does not accept wildcard patterns. |
| page | string | – | Specify which page of results to retrieve in the paginated response. Page numbering starts at 0. |
| size | string | – | Set the maximum number of topics to return per page. Must be a non-negative integer. |
| subcategory | string | – | Narrow results to a specific subcategory within the selected category for more granular topic classification. |
No output schema declared.
No examples provided.
search_wikipedia Search Wikipedia ~123
Search Wikipedia using natural language queries to find page sections ranked by semantic relevance to your search intent.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | Optional filter to narrow search results by specific criteria. |
| page | string | – | Page number for pagination, starting from 0 up to 10000. Defaults to 0 for the first page. |
| prompt | string | yes | Natural language query describing what you want to find. Supports up to 1024 characters. |
| size | string | – | Number of results to return per page, between 1 and 100 items. Defaults to 10. |
No output schema declared.
No examples provided.
search_wikipedia_pages Search Wikipedia Pages ~546
Search and retrieve Wikipedia pages from the Perigon using flexible filtering criteria across titles, summaries, content, and references. Results are returned as paginated collections that can be sorted by relevance, recency, or viewership.
| Name | Type | Req | Description |
|---|---|---|---|
| category | array | – | Filter pages by Wikipedia categories. Provide one or more category names as an array. |
| id | array | – | Retrieve specific pages by their unique Perigon identifiers. Provide one or more IDs as an array to return a targeted collection of pages. |
| page | string | – | Specify which page of results to retrieve in the paginated response, starting from 0. Maximum page number is 10000. |
| reference | string | – | Search across page references and citations using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (*) for pattern matching. |
| sectionId | array | – | Retrieve pages containing specific section identifiers. Each section ID is unique within the Wikipedia dataset; provide one or more as an array. |
| size | string | – | Set the number of articles to return per page in the paginated response. Maximum is 1000 results per page. |
| sortBy | string | – | Sort results by relevance (default), revision timestamp (ascending or descending for recently edited), page views (ascending or descending for viewership), or scrape timestamp (ascending or descendin… |
| summary | string | – | Search within page summaries using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (*) for pattern matching. |
| text | string | – | Search across all page content and sections using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (*) for pattern matching. |
| title | string | – | Search within page titles using Boolean operators (AND, OR, NOT), exact phrase matching with quotes, and wildcards (*) for pattern matching. |
| wikiNamespace | array | – | Filter pages by wiki namespace. Currently only the main namespace (0) is supported. |
| wikidataId | array | – | Retrieve pages by their corresponding Wikidata entity identifiers. Provide one or more Wikidata IDs as an array. |
| wikidataInstanceOfId | array | – | Retrieve pages whose Wikidata entities are instances of the specified Wikidata IDs. Provide one or more IDs as an array. |
| wikidataInstanceOfLabel | array | – | Retrieve pages whose Wikidata entities are instances of the specified labels. Provide one or more Wikidata entity labels as an array. |
| withPageviews | boolean | – | When enabled, return only pages that have viewership statistics available. Defaults to false, which returns all matching pages regardless of viewership data. |
No output schema declared.
No examples provided.
Common questions
What is the com.mcparmory/perigon MCP server?
com.mcparmory/perigon is an MCP server listed in the public MCP registry as com.mcparmory/perigon. Search real-time news articles, companies, journalists, and trending topics. This page covers its PyPI package (mcparmory-perigon).
Is the com.mcparmory/perigon MCP server safe to use?
com.mcparmory/perigon scores 72 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the com.mcparmory/perigon MCP server expose?
com.mcparmory/perigon exposes 14 tools: search_articles, search_companies, search_journalists, get_journalist, search_people, and 9 more. Their descriptions and schemas cost roughly 10,986 tokens of context every time the server is loaded.
Is the com.mcparmory/perigon MCP server still maintained?
com.mcparmory/perigon is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.