platform
Watchlists, source groups, contact points, article refresh status, and getapiaccess.
How to use it
platform is exposed by the Perigon MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the platform tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Perigon MCP Server
npx -y mcp-remote@latest https://mcp.perigon.io/v1/mcp --header Authorization: Bearer ${PERIGON_API_KEY}Other tools in Perigon MCP Server (36)
Check a background article-refresh job's status, or peek cached refresh data for up to 100 article IDs — read-only, cannot submit new jobs.
List or get by UUID your organization's monitor notification delivery channels (email/webhook).
Always available. Reports this key's scopes, organization, usage quota, and the derived entitlement behavior (stripped fields, blocked filters, date-window clamps). Call once per session, or after a 403 or an unexpectedly null/empty field — does not count against request quota.
Article publication volume bucketed over time — pair with getavgsentiment on identical filters for a trend view.
Average sentiment (positive/negative/neutral) bucketed over time for articles matching a filter set.
Retrieve a monitor's complete configuration, including its objective, query, output schema, schedule, watchlist, and contact points.
Retrieve structured events emitted by EVENT and MENTIONS monitors with extracted data, entities, summaries, and related articles.
Retrieve scheduled human-readable briefings generated by monitors, typically for TOPIC monitors.
Retrieve rolling AI-generated monitor summary history.
Look up one news source by exact ID or domain for full detail (paywall status, alt names, location).
Story-level (clustered headline) publication volume or velocity over time.
Companies whose coverage is spiking relative to a baseline period.
The most frequently mentioned topics, people, companies, cities, journalists, or sources.
People whose coverage is spiking relative to a baseline period.
Topics whose coverage is spiking relative to a baseline period.
List and filter monitors by UUID, name, lifecycle status, or EVENT, MENTIONS, and TOPIC classification.
searchnewsarticles plus the five stats tools and getapiaccess — the smallest useful research set.
All monitor tools (including createmonitor/updatemonitor) plus every Signal Insights tool.
Core search, stats, and lookup tools for news research (articles, stories, journalists, sources, people, companies, topics, stats, getsourcebyid, getapiaccess).
Activate, pause, or archive a monitor. Archiving cannot be reversed through the public API.
Setup
Sandbox
Data
Files
Files
Read
Sandbox
Files
Read
Read
Read
Sandbox
Files
Files
List, get by ID, or resolve by name your organization's custom source-group bundles.
List, get by ID, or resolve by name your organization's watchlists of people and companies.