Connect Perigon to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the search journalists tool in Perigon
Use the search wikipedia tool in Perigon
Use the search topics tool in Perigon
Use the search companies tool in Perigon
Use the search sources tool in Perigon
Use the search articles tool in Perigon
Supported Tools
search_journalists
Search Journalists
Search Perigon's database of 230,000+ journalist and reporter profiles. Returns journalist details including bio, publications, coverage areas, and publishing activity. Use this to find journalists covering specific topics or writing for specific publications.
search_wikipedia
Search Wikipedia
Search Wikipedia pages for information on any topic. Returns page summaries, full content, categories, pageview data, and Wikidata metadata. Supports filtering by language, pageview threshold, Wikidata entity type, and Wikipedia category.
search_topics
Search Topics
Browse available news topics and categories supported by Perigon. Use this to discover valid topic names that can be passed as filters to the Search Articles and Search Stories tools.
search_companies
Search Companies
Search company profiles referenced in news articles. Returns company details including CEO, employee count, industry, sector, and headquarters location. Use quoted names for exact matching (e.g. `"Airbnb"`).
search_sources
Search Sources
Discover and retrieve information about the 160,000+ media sources indexed by Perigon. Filter sources by name, domain, country, category, topic, audience, publishing volume, or paywall status. Returns source details including publishing volume and content focus areas.
search_articles
Search Articles
Search and retrieve news articles from 200,000+ global sources. Supports keyword search with Boolean operators (AND, OR, NOT) and filtering by source, category, topic, country, date range, sentiment, people, and companies mentioned. Each article includes AI-enriched metadata like sentiment scores, entity extraction, and summaries.
search_stories
Search Stories
Search story clusters — groups of related articles covering the same event or topic. Returns aggregate data including article counts, sentiment breakdown, AI-generated summaries, and entity mentions across all articles in each cluster. Use the returned storyId with the Search Articles tool (as clusterId) to retrieve individual articles within a story.
search_people
Search People
Search Perigon's database of 650,000+ public figures, politicians, celebrities, and newsworthy individuals. Returns biographical information including occupations, positions held, and aliases. Use quoted names for exact matching (e.g. `"Jeff Bezos"`).
get_account_usage
Get Account Usage
Identify the organization connected to this API key and retrieve account usage, request limits, page limits, and usage reset dates. This endpoint does not consume the monthly request quota.
Enable Perigon in Metorial. In your Metorial portal, enable the Perigon MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Perigon tools.
Enable Perigon in Metorial. In your Metorial portal, enable the Perigon MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Perigon tools.
Enable Perigon in Metorial. In your Metorial portal, enable the Perigon MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Perigon tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Perigon in Metorial. In your Metorial portal, enable the Perigon MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Perigon tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Perigon in Metorial. In your Metorial portal, enable the Perigon MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Perigon tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Perigon through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Perigon and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Perigon tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Search news articles and story clusters with keyword, entity, source, location, date, and sentiment filters. Discover people, companies, journalists, media sources, and topics; search Wikipedia pages; and identify the connected organization and account usage limits.
Frequently asked questions
Common questions about connecting Perigon to AI agents with Metorial.
How many tools does the Perigon MCP server have?
The Perigon MCP server exposes 9 tools, including Search Journalists, Search Wikipedia, Search Topics. Each one is governed and traced through Metorial.
Does the Perigon MCP server support triggers?
Perigon exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Perigon MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Perigon MCP server through the same Metorial URL.
How do I give only some teams access to Perigon?
Use role-based access control to decide which teams, users, and agents can use Perigon and which of its tools they can call.
Can I self-host the Perigon MCP server?
Yes. Metorial is open source, so you can run the Perigon MCP server yourself or use the hosted gateway.
Connect Perigon to production AI agents
See how Metorial gives your team governed access to Perigon, with tracing and security controls built in.