Skip to main content
Use Perigon through Corsair: one client, typed API calls. Authenticate with the API key from the Developers section of your Perigon account; the plugin sends it in the x-api-key header (the docs also allow a query parameter and a Bearer header — the header keeps the key out of URLs). Every route here is a GET. Articles API returns one result per published article URL; Stories API returns clustered narratives. The limits endpoint is free to poll — it does not count against your quota — and reports requestsUsed, requestLimit and resetAt. Article body text may be truncated on some plans; check articleContentTruncation in limits.get. Lists answer { status, numResults, articles } (articles) or { status, numResults, results } (the rest); numResults is the total match count and pages are numbered from 0. Filters that take several values (source, topic, country, …) accept a list and OR them. This plugin exposes the common filters from Perigon’s OpenAPI. Monitors, Social (X, Reddit, LinkedIn), vector search and the summarizer are documented by Perigon but not part of this plugin. Every operation is described in the official docs: https://docs.perigon.io/openapi.json What you get:
  • 6 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Search articles
Write No write-style endpoint inferred; pick any operation from the API reference. See the full list on the API page.

What’s next

API reference

Every perigon.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.