# Currents API — how to use (mcp.ai)

Connect your Currents API account and use 5 tools for news and lifestyle straight from your AI agent. Connect with your own API key. Currents News API provides access to the latest news articles from various sources worldwide, supporting multiple languages and categories.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_currents_api?ms=1787293320000`
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. `currents_api_activities_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/currents_api`
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/currents_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/currents_api/activities/list` — Tool to retrieve the latest news articles from Currents News API. Use when you need a real-time feed of recent articles.
  - body: { language?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/currents_api/activities/watch` — Start a push notification channel to watch user activities for Google Workspace applications. This action sets up a webhook to receive real-time notifications when activities occur in Google Workspace
  - body: { channel: object, user_key: string, application_name: string }
- `POST https://api.mcp.ai/api/currents_api/entity/usage/reports/get` — Tool to retrieve usage statistics for a specific Google Workspace entity. Use when you need to analyze entity usage on a particular date.
  - body: { date: string, filters?: string, entityKey: string, pageToken?: string, customerId?: string, entityType: string, maxResults?: integer, parameters?: string }
- `POST https://api.mcp.ai/api/currents_api/user/usage/report/get` — Retrieve news articles from Currents News API with flexible search and filtering. Use this tool to: - Search for news articles by keywords or phrases - Filter articles by language, category, country, 
  - body: { country?: string, category?: string, end_date?: string, keywords?: string, language?: string, page_size?: integer, start_date?: string, page_number?: integer }
- `POST https://api.mcp.ai/api/currents_api/users/list` — Tool to list users in a Google Workspace domain. Note: - When the provided base_url points to Currents News API (api.currentsapi.services), this action will gracefully fall back to listing latest news
  - body: { query?: string, domain?: string, orderBy?: string, customer?: string, viewType?: string, pageToken?: string, sortOrder?: string, maxResults?: integer, projection?: string, showDeleted?: boolean, customFieldMask?: string }

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

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