Official Perigon news API: articles, stories, companies, journalists, monitors, and stats.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Perigon, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
Perigon MCP
Perigon's hosted MCP server for real-time news, entities, and monitors.
- 🚀 Quick start
- 🔧 Choosing tools
- 🛠️ Tools
- 📚 Prompts and resources
- 📊 Signal Insights workflow
- 💡 Prompting tips
- 📦 MCP Registry
- 💻 Local development
- 👥 Contributing and maintainers
- ⚖️ License
Quick start
Endpoint: https://mcp.perigon.io/v1/mcp
Auth: Authorization: Bearer <key> — create a key at perigon.io/dev/keys.
Try it in the playground (requires a signed-in Perigon dashboard session). Client-specific setup: dev.perigon.io/docs/mcp.
Native Streamable HTTP (recommended):
mcp-remote (clients without native HTTP):
Claude Code:
SSE at /v1/sse exists for legacy clients. Use Streamable HTTP for new integrations.
Choosing tools
Append ?tools= to the MCP URL to limit the session. ?tool= is an alias and wins if both are present.
- Comma-separated tool names, profile aliases, or a mix.
- The filter intersects with what the key's scopes already allow. It cannot expand access.
- Omit the parameter, pass an empty value, or pass
all→ default set (opt-in tools stay off). - Unknown names are dropped. If every name is unknown, the default set is used.
| Profile | Tools |
|---|---|
research | search_news_articles, search_news_stories, search_story_history, search_vector_news, summarize_news, search_journalists, search_sources, search_people, search_companies, search_topics, the five stats tools, get_top_topics, get_source_by_id, get_api_access. Not Wikipedia, and not the company / person / location shortcuts. |
monitoring | All monitor tools (including create_monitor / update_monitor) plus every Signal Insights tool. |
platform | watchlists, create_watchlist, update_watchlist, source_groups, create_source_group, update_source_group, contact_points, article_refresh, get_api_access. |
minimal | search_news_articles, the five stats tools, get_api_access. |
get_story_stats is not in any profile. Request it by name. It still requires CLUSTERS at call time; a key without that scope can select the tool and then get a permission error.
Other opt-in tools need no extra scope. Any valid key can request them.
Tools
Availability:
- Default — registered when
?tools=is omitted (and the key has the listed scope, if any). - Scope — registered only when the key has that permission.
- Opt-in — omitted from the default set. Request by name or profile. Registration is not the same as API access.
Search
| Tool | Availability | Description |
|---|---|---|
search_news_articles | Default | Keyword and filter search over individual articles, including Boolean queries. |
search_news_stories | Scope: CLUSTERS | Clustered headlines that group related articles into one narrative. |
search_story_history | Scope: CLUSTERS | Timestamped snapshots of how a story cluster changed. |
search_vector_news | Scope: VECTOR_SEARCH_NEWS | Semantic search over recent articles. |
summarize_news | Scope: SEARCH_SUMMARY | AI summary of matching articles, with citations. |
search_journalists | Scope: JOURNALISTS | Journalist and reporter profiles. |
search_sources | Scope: SOURCES | News publications and outlets. |
search_people | Scope: PEOPLE | Public-figure profiles. |
search_companies | Scope: COMPANIES | Company profiles (domain, ticker, industry). |
search_topics | Scope: TOPICS | Perigon topic taxonomy for exact topic filters. |
search_wikipedia | Scope: WIKIPEDIA | Keyword search of Wikipedia pages. |
search_vector_wikipedia | Scope: VECTOR_SEARCH_WIKIPEDIA | Semantic search of Wikipedia pages. |
Shortcuts
Each tool looks up an entity, then searches recent articles about it.
| Tool | Availability | Description |
|---|---|---|
get_company_news | Scope: COMPANIES | Recent articles about a company looked up by name. |
get_person_news | Scope: PEOPLE | Recent articles about a person looked up by name. |
get_location_news | Scope: LOCATIONS | Recent articles for a city, state, or country. |
Stats
Always on for any valid key. Prefer these over counting search results by hand.
| Tool | Availability | Description |
|---|---|---|
get_avg_sentiment | Default | Average sentiment (positive / negative / neutral) bucketed over time. |
get_article_counts | Default | Article publication volume bucketed over time. |
get_top_entities | Default | Most-mentioned topics, people, companies, cities, journalists, or sources. |
get_top_people | Default | People whose coverage is spiking versus a baseline. |
get_top_companies | Default | Companies whose coverage is spiking versus a baseline. |
Access
| Tool | Availability | Description |
|---|---|---|
get_api_access | Default | This key's scopes, organization, quota, and entitlement behavior. Does not count against request quota. Call once per session, or after a 403. |
Monitors
Read tools are default. Write tools are opt-in because the shared monitor schema is large.
| Tool | Availability | Description |
|---|---|---|
list_monitors | Default | List and filter monitors by UUID, name, status, or EVENT / MENTIONS / TOPIC. |
get_monitor | Default | Full monitor configuration. |
get_monitor_events | Default | Structured events from EVENT and MENTIONS monitors. |
get_monitor_newsletters | Default | Scheduled briefings, typically from TOPIC monitors. |
get_monitor_summaries | Default | Rolling AI-generated monitor summary history. |
set_monitor_status | Default | Activate, pause, or archive a monitor. Archiving cannot be reversed through the public API. |
create_monitor | Opt-in | Create a DRAFT or ACTIVE monitor. Defaults to DRAFT. |
update_monitor | Opt-in | Partial update; omitted fields are preserved. |
Platform
All of these are opt-in. get_source_by_id and get_top_topics are also in research. get_story_stats is name-only.
| Tool | Availability | Description |
|---|---|---|
get_source_by_id | Opt-in | One news source by exact ID or domain. |
get_top_topics | Opt-in | Topics whose coverage is spiking versus a baseline. |
get_story_stats | Opt-in; Scope: CLUSTERS | Story-level publication volume or velocity over time. |
watchlists | Opt-in | List, get, or resolve organization watchlists. |
create_watchlist / update_watchlist | Opt-in | Create or partially update a watchlist. |
source_groups | Opt-in | List, get, or resolve custom source-group bundles. |
create_source_group / update_source_group | Opt-in | Create or partially update a source group. |
contact_points | Opt-in | List or get monitor notification channels (email / webhook). |
article_refresh | Opt-in | Check a refresh job or peek cached data for up to 100 article IDs. Read-only. |
Signal Insights
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Perigon
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/perigon)HTML Embed
<a href="https://allmcps.com/mcp/perigon"><img src="https://allmcps.com/api/badge/perigon?style=directory" alt="Perigon on AllMCPs" /></a>