MCP ExplorerExplorer

Perigon Mcp Server

@goperigonon a year ago
4 Apache-2.0
FreeCommunity
AI Systems
WIP: Official MCP server for the Perigon API

Overview

What is Perigon Mcp Server

The perigon-mcp-server is the official MCP server designed for the Perigon API, facilitating the management and integration of data.

Use cases

Use cases include developing applications that require data from the Perigon API, testing API integrations, and managing data workflows in a local environment.

How to use

To use the perigon-mcp-server, install the necessary packages with ‘bun i’ and start the server along with the MCP inspector using ‘bun start’.

Key features

Key features include efficient package management with bun, integration with the Perigon API, and the capability to run a local MCP server for development and testing.

Where to use

The perigon-mcp-server can be used in various fields such as software development, data integration, and API management.

Content

Perigon logo

Perigon MCP Server

This is the official MCP server for the Perigon news API.

Usage

Connecting

You can connect to our remote MCP server using local MCP clients, by using the mcp-remote proxy.

You can simply add the following JSON to your MCP config for your application. Don’t forget to update PERIGON_API_KEY to
have your apiKey
.

{
  "mcpServers": {
    "perigon_news_api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.perigon.io/v1/sse",
        "--header",
        "Authorization: Bearer ${PERIGON_API_KEY}"
      ],
      "env": {
        "PERIGON_API_KEY": "..."
      }
    }
  }
}

Prompt Examples

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 headlines in the United States today.
  • What is happening in Ireland today?
  • Give me top stories this past week in North American countries.

Supported tools

Tool Description
get_top_headlines Fetches trending news stories by country, category, and timeframe
read_news_articles Searches news articles with flexible query options and filtering

Issues / Contributing

Issues

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

Contributing

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.

Local development

We are using bun for package mgmt.

bun i

# Runs the mcp server and the mcp inspector
bun start

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers