# Perigon — how to use (mcp.ai)

Connect your Perigon account and use 9 tools for news and lifestyle straight from your AI agent. Connect with your own API key. Perigon provides an HTTP REST API for retrieving news and web content data, offering structured data suitable for various applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_perigon?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `perigon_get_articles`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/perigon`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/perigon/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/perigon/get/articles` — Tool to retrieve a list of news articles based on filters. Use when keywords, sources, or date ranges are specified.
  - body: { q?: string, to?: string, from?: string, page?: integer, sortBy?: string, country?: string, domains?: string, sources?: string, category?: string, language?: string, pageSize?: integer, excludeDomains?: string }
- `POST https://api.mcp.ai/api/perigon/get/companies` — Tool to retrieve information on companies in Perigon’s entity database. Use when you need a full list of companies. Use after confirming a valid API key is present.
- `POST https://api.mcp.ai/api/perigon/get/journalists` — Tool to retrieve journalist profiles including title, Twitter handle, bio, and location. Use when you need detailed journalist info to enrich content with author metadata.
  - body: { limit?: integer, query?: string, offset?: integer, outlet?: string }
- `POST https://api.mcp.ai/api/perigon/get/sources` — Tool to retrieve a list of media sources with filtering options. Use when you need to list sources by domain, country, category, or traffic metrics.
  - body: { page?: integer, domain?: string, country?: string, category?: string, language?: string, per_page?: integer, max_stories?: integer, max_traffic?: integer, min_stories?: integer, min_traffic?: integer, exclude_domains?: string, include_domains?: string }
- `POST https://api.mcp.ai/api/perigon/get/stories` — Tool to retrieve clusters of related articles covering the same event or topic with aggregate metrics. Use when you need to fetch filtered and sorted story clusters after configuring query parameters.
  - body: { q?: string, ids?: string, page?: integer, type?: string, image?: boolean, video?: boolean, domain?: string, sortBy?: string, cluster?: integer, country?: string, not_ids?: string, paywall?: boolean, sources?: string, to_date?: string, category?: string, language?: string, from_date?: string, max_score?: number, min_score?: number, sentiment?: string, cluster_min_score?: number }
- `POST https://api.mcp.ai/api/perigon/get/topics` — Tool to retrieve all available Perigon news topics. Returns a list of topics that can be used to filter articles or stories. Each topic includes an ID, name, and labels (category/subcategory).
- `POST https://api.mcp.ai/api/perigon/get/wikipedia` — Tool to search and filter Wikipedia pages. Use when you have a search query ready and want to retrieve relevant Wikipedia articles.
  - body: { q: string, page?: integer, size?: integer, language?: string }
- `POST https://api.mcp.ai/api/perigon/vector/search/articles` — Tool to perform a vector search on Perigon’s real-time news database. Use when you need to retrieve semantically similar news articles given a natural language query.
  - body: { query: string, top_k?: integer, filter?: object, vector_options?: object, include_vectors?: boolean }
- `POST https://api.mcp.ai/api/perigon/vector/search/wikipedia` — Tool to perform semantic retrieval of Wikipedia pages using vector search. Use after obtaining a search query to find relevant Wikipedia articles.
  - body: { limit?: integer, query: string, include_context?: boolean }

## Example prompts
- "What can I do in Perigon?"
- "Show me a summary of my Perigon account"

## More
- Page: https://mcp.ai/perigon
- Agent spec (llms.txt): https://mcp.ai/perigon/llms.txt
- Postman collection: https://mcp.ai/perigon/postman.json