Associated Press Media API

You can access AP Media API content through an AI-optimized MCP server that translates natural language queries into AP API requests, enabling conversational AI to search, monitor, and analyze news content with intelligent prompts, caching, and real-time feeds.

How to use

You interact with the AP Media MCP Server through an MCP-compatible client. Your AI application can ask for breaking news, trending topics, or related articles using natural language. The server automatically converts those requests into optimized AP API calls, returns the results, and enforces content access according to your configured plan. Use tools for search, analysis, content recommendations, trend detection, monitoring, and automated workflows to build rich AI-driven news experiences.

How to install

Prerequisites you need before installing the MCP server are Node.js 18 or newer and a valid Associated Press API key.

{
  "mcpServers": {
    "ap_media": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ap-mcp-server@latest"],
      "env": {
        "AP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Additional sections

Configuration emphasizes secure access and performance, including environment-based validation, intelligent caching, and strict plan enforcement by default.

Environment variables shown in the configuration include AP_API_KEY as a required key, with optional settings for base URL, timeouts, retries, and debugging. You should tailor these based on your network and AP plan.

Security practices include using HTTPS for all requests, keeping API keys in environment variables only, validating inputs, and enforcing plan-based access to prevent unintended content usage.

If you need to extend or customize, you can enable verbose logging or adjust cache TTLs to balance freshness and performance.

Available tools

search_content

Advanced content search with flexible filtering and sorting options. Supports pagination, include/exclude filters, and in_my_plan filtering for authorized access.

search_content_all

Auto-paginated search for large result sets (up to 2,000 items). Automatically handles pagination for bulk analysis.

get_content_item

Retrieve a specific content item by its ID with optional field filtering and pricing information.

get_content_bulk

Retrieve multiple content items efficiently (up to 50 items) for batch processing.

get_content_feed

Access the live AP content feed for real-time news updates.

get_rss_feeds

List RSS feeds available for your account.

get_rss_feed

Access a specific RSS feed by ID with pagination and filtering.

get_ondemand_content

Access your organization’s OnDemand queue for queued content.

optimize_search_query

Convert natural language queries into optimized AP API searches using NLP.

analyze_content_trends

Analyze trending topics and patterns in news content across time ranges and categories.

get_content_recommendations

Get AI-powered content recommendations based on a reference item.

get_trending_subjects

Fast discovery of currently trending topics with caching support.

get_account_info

Retrieve basic account information and available endpoints.

get_account_plans

Fetch account plans, entitlements, and usage meters.

get_account_downloads

Retrieve download history with date range filtering and format options.

get_account_quotas

Check current API quotas and usage limits.

get_followed_topics

Manage and view topics you are following.

create_monitor

Create content monitors for automated alerts with notification settings.

list_monitors

List all existing content monitors.

get_monitor

Get detailed information about a specific monitor.

update_monitor

Update an existing monitor's settings.

delete_monitor

Delete a monitor.

get_monitor_status

Check the status of a monitor.

get_monitor_history

Retrieve historical data for a monitor.

build_search_query

Build structured search queries with validation and content-type filters.

get_content_rendition

Fetch full article renditions (NITF text, images, videos, etc.) via href URLs.

trend-analysis

Analyze trending topics and patterns within a specified timeframe.

content-curation

Curate content for specific audiences or purposes based on topics and content mix.

story-development

Assist in developing stories with background and context using topic needs.