Perigon MCP Server

The Perigon MCP Server is developed and maintained by the Perigon engineering team.

Lead Developer: Islem Maboud, responsible for the architecture, implementation, and ongoing development of this MCP server, including the remote transport layer, authentication handling, deployment configuration, and the MCP playground.

You can connect to our remote MCP server using any MCP-compatible client.

The recommended transport isStreamable HTTP(/v1/mcp). SSE (/v1/sse) is supported for legacy clients but not recommended for new integrations.

Streamable HTTP — native support (recommended):

{ "mcpServers": { "perigon_news_api": { "url": "https://mcp.perigon.io/v1/mcp", "type": "http", "headers": { "Authorization": "Bearer YOUR_PERIGON_API_KEY" } } } }

Streamable HTTP — viamcp-remote(for clients without native HTTP support):

By default all tools permitted by your API key are available. You can restrict a session to a smaller set by appending a?tools=query parameter to the server URL. This is useful for reducing context size and keeping the model focused.

https://mcp.perigon.io/v1/mcp?tools=search_news_articles,search_news_stories

- Pass a comma-separated list of tool names, orallto explicitly activate every permitted tool.
- Only tools your API key already has access to will be activated — the parameter cannot expand permissions.
- Omitting the parameter, passing an empty value, or passingallare all equivalent and activate every permitted tool.

Example — Cursor config scoped to article and story search:

{ "mcpServers": { "perigon_news_api": { "url": "https://mcp.perigon.io/v1/mcp?tools=search_news_articles,search_news_stories", "type": "http", "headers": { "Authorization": "Bearer YOUR_PERIGON_API_KEY" } } } }

Instead of listing individual tool names,?tools=also accepts curated profile aliases — useful shorthand for reducing context to a task-appropriate subset:

Profiles can be combined with explicit tool names in the same?tools=value (e.g.?tools=research,create_monitor), and are always intersected with what your API key's scopes actually permit.

When prompting your agent we recommend providing the current date (or a tool to get it) unless the agent already has access to such information, this is because some models like Claude will otherwise think the current date is their knowledge cutoff and they will retrieve outdated information frequently.

- Give me the top 5 political headlines in the United States from today.
- What business stories are trending in New York today?
- Show me the latest tech news from California this week.
- Find political news from swing states in the last 3 days.
- Show me cryptocurrency-related stories from the past week.

- Find local news sources in Texas.
- Who are the top business journalists at major publications?
- Find journalists covering renewable energy, then show me their recent articles.
- Which journalists write the most about climate policy?
- Show me articles from major financial publications today.

- Find recent news about pharmaceutical company CEOs.
- Search for Tesla as a company, then find recent news stories about them.
- Show me companies in the electric vehicle industry.
- Search for politicians mentioned in healthcare stories.
- What are tech companies saying about AI regulation?

- List my active event monitors.
- Show me the latest events detected by my product recall monitor.
- Create a draft monitor for executive departures in the semiconductor industry.
- Pause my competitor mentions monitor.
- Show me the latest newsletter from my AI regulation topic monitor.

The five stats tools are always available regardless of scope — the underlying/v1/stats/*endpoints perform no permission check beyond a valid key — and give aggregate metrics computed server-side, which is generally preferable to counting search results by hand.

The six read tools below are always available and expose the public/v1/api/monitorsAPI for reading monitor configuration and output.create_monitorandupdate_monitorare not always-on — request them explicitly via?tools=create_monitor,update_monitoror themonitoringprofile, since most sessions never call them and the shared monitor schema is large.

Read-only by default; opt in via?tools=(by name or theplatformprofile).

The server also registers six reusable MCP prompts that encode multi-step tool-chaining playbooks, so a host that surfaces prompts gets correct chaining without relying on the model to reconstruct it:entity_deep_dive,narrative_trace,coverage_trend,journalist_beat_profile,competitive_landscape, andspike_explainer.

Long-form guidance is available on-demand as MCP resources rather than always-on instructions:perigon://reference/fields(response field semantics),perigon://reference/chaining(cross-endpoint research playbooks),perigon://reference/entitlements(this session's scope-to-behavior mapping), andperigon://reference/charts(Signal Insights chart formatting rules).

API keys with theSignal Insightsscope unlock an additional set of tools for querying, exporting, and analyzing your AI signals data with a persistent Python sandbox.

{ "mcpServers": { "perigon": { "url": "https://mcp.perigon.io/v1/mcp?tools=signal_insights_create_workspace,signal_insights_search_signals,signal_insights_read_signal,signal_insights_list_newsletters,signal_insights_read_newsletter,signal_insights_export_events,signal_insights_execute_code,signal_insights_preview_chart,signal_insights_shell,signal_insights_list_files,signal_insights_read_file,signal_insights_write_file,signal_insights_grep,signal_insights_str_replace", "type": "http", "headers": { "Authorization": "Bearer YOUR_PERIGON_API_KEY" } } } }

Example config — Signal Insights combined with news tools

{ "mcpServers": { "perigon": { "url": "https://mcp.perigon.io/v1/mcp", "type": "http", "headers": { "Authorization": "Bearer YOUR_PERIGON_API_KEY" } } } }

With no?tools=filter, all tools permitted by your API key's scopes are active.

This MCP server is still in development as we determine what use cases our users want to solve with this server. But if you have any special requests or features you would like to see, don't hesitate to open a github issue on this Repo. We will gladly accept any feedback

This tool is intentionally open source so if you want to see some particular feature you open an issue or open a PR and someone at Perigon will review it.

Add the following environment variables to.dev.vars

If you wish to contribute to the MCP playground (tools inspector & chat), please make sure to modify your network hosts file (/etc/hosts on mac) to include the following

# install deps bun i # Runs the mcp server and the mcp playground bun dev

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Objective-driven deep research paid per request via MPP - free daily quick search (news/arXiv), quote-first paid cloud-browser research with cross-source reports. MCP Streamable HTTP, no API key.

About Free multi-engine MCP search server — 8 free engines (DDG, Sogou, Bing, Baidu, Wikipedia, Startpage, Yandex, Mojeek), waterfall progressive search, multi-source verification, content enrichment, news search, language auto-detection, rate limit exposure. Zero API keys needed. Self-hostable.

Read-only MCP server for neutral, bias-scored news — search articles, get verification-gated event writeups, and compare left/center/right media-bias framing.

Real-time ranked tech feed from Hacker News, arXiv, Dev.to, and more. Query live stories by category, search by keyword, and surface what the tech community is reading right now.

Fetch and interact with Hacker News content, including top stories, comments, and search functionality.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.