Perigon

Perigon MCP Server provides a remote connection point to the Perigon news API via a dedicated MCP endpoint. You can stream, query, and filter news data through HTTP or server-sent events, enabling efficient and scalable access for your applications and agents.

How to use

You connect to the Perigon MCP Server from your MCP client to start receiving live news data. Use the HTTP streamable endpoint for continuous data flow or the Server-Sent Events (SSE) endpoint for real-time updates. If you need to run a local or remote client, choose the method that best fits your environment and authentication capabilities.

How to install

Prerequisites: you need a modern Node-like runtime or Bun for package management. You also need a Perigon API key to access the MCP server held at Perigon.

Install and run the server locally using the Bun toolkit, as shown in the development workflow.

# install dependencies
bun i

# run the MCP server and the playground
bun dev

Additional sections

Configuration options for the Smithery deployment include an API key and a rate-limiting bypass flag. The MCP endpoint is exposed at /mcp and accepts Smithery’s query parameter configuration format.

API key required for connecting to Perigon services is documented alongside deployment settings. You can adjust rate limiting via the provided flag to suit containerized environments.

Prompt examples help you craft requests for news articles, journalists, sources, and topics. They guide you to fetch current headlines, trends, and specific categories across locations and time ranges.

If you encounter issues during setup or usage, verify that your API key is valid, confirm your network access to the MCP endpoints, and ensure your client supports the chosen transport (HTTP or SSE). Start with the simplest connection method and gradually enable more advanced features as needed.

Available tools

search_news_articles

Search individual news articles with advanced filtering by keywords, location, time range, sources, and journalists. Returns full article content or summaries with metadata.

search_news_stories

Search clustered news stories and headlines. Returns story summaries, sentiment analysis, and metadata for understanding major news events and trends across multiple sources.

search_journalists

Find journalists and reporters by name, publication, location, or coverage area. Returns journalist profiles with their top sources, locations, and monthly posting activity.

search_sources

Discover news publications and media outlets by name, domain, location, or audience size. Returns source details including monthly visits, top topics, and geographic focus.

search_people

Search for public figures, politicians, celebrities, and newsworthy individuals. Returns biographical information including occupation, position, and detailed descriptions.

search_companies

Find corporations and businesses by name, domain, or industry. Returns company profiles with CEO information, employee count, industry classification, and business descriptions.

search_topics

Search topics currently supported via Perigon API for discovering available news categories and subjects.

search_wikipedia

Search Wikipedia pages for information on any topic. Returns page summaries, content, categories, and metadata with support for advanced filtering by Wikidata entities, categories, and page views.

search_vector_wikipedia

Search Wikipedia pages using semantic vector search for more contextual and meaning-based results. Returns page summaries, content, categories, and metadata.