MCP Server

PulitzerAI MCP Server는 OpenAPI 기능을 Agent가 호출하기 쉬운 Tool 단위로 제공하는 표준 인터페이스입니다.

개요

MCP는 REST endpoint를 그대로 노출하지 않고, tools/list와 tools/call 기반의 JSON-RPC 2.0 인터페이스로 동작합니다. 조회, AI 생성/수정, 비동기 수집, 배포 준비, 성과 분석처럼 Agent 연동에 적합한 작업을 Tool로 제공합니다. 삭제·결제·실제 외부 배포 실행·파일 다운로드처럼 별도 확인이 필요한 작업은 MCP Tool로 제공하지 않습니다.

엔드포인트

https://api.pulitzer.ai/live/tools/mcp
Transport는 Streamable HTTP이며, 요청 본문은 MCP JSON-RPC 2.0 메시지입니다.

인증

권장 인증 방식은 OAuth 2.0 Authorization Code 흐름입니다. MCP Client가 OAuth metadata를 발견한 뒤 PulitzerAI 로그인/승인 화면으로 이동하고, 승인 완료 후 access token을 발급받아 Tool 호출 시 Authorization: Bearer 헤더로 전달합니다. 기존 API Key 방식은 하위 호환을 위해 Authorization: Bearer 또는 PULITZER-API-KEY 헤더로 허용됩니다.

Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN

# Compatibility only
PULITZER-API-KEY: YOUR_API_KEY

Tool Catalog

도메인Tools
기자 데이터
get_reporter_categoriessearch_reporterssearch_reporters_by_media
빌링
get_api_credit_balanceget_api_usage_historyget_api_daily_usageget_api_monthly_usageget_api_cost_config
보도자료/콘텐츠
generate_press_releasemodify_press_releasegenerate_blog_postgenerate_sns_contentcreate_adcopycreate_generic_contenttranslate_articletranslate_text
뉴스클리핑
list_newsclip_feedssearch_newsclip_articlesquick_search_newsget_newsclip_articlerequest_news_clipping_custom_collectget_news_clipping_custom_collect_status
배포/성과
prepare_releasecreate_release_draftget_release_statusget_release_resultanalyze_campaign_performancerank_reporters_by_performancerank_media_by_performance
CRM 워크스페이스
list_crm_workspaceslist_workspace_reportersadd_workspace_reporterrecord_reporter_meetingsummarize_workspace_pr_outcomes

호출 예시

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "search_reporters",
    "arguments": {
      "category_names": [
        "경제",
        "IT"
      ],
      "page": 1,
      "page_size": 10
    }
  }
}
{
  "content": [
    {
      "type": "text",
      "text": "기자 검색이 완료되었습니다."
    }
  ],
  "structuredContent": {
    "summary": "기자 10명을 찾았습니다.",
    "data": [],
    "billing": {
      "charged": true,
      "credit_kind": "API_CREDIT"
    }
  }
}

운영 정책

  • OAuth access token은 Tool input이 아니라 Authorization Bearer 헤더로 전달합니다.
  • MCP session id는 인증 정보가 아니며, 사용자 식별은 OAuth token subject 또는 호환 토큰의 사용자 정보로 수행합니다.
  • 뉴스 수집처럼 오래 걸리는 작업은 request Tool이 collect_id를 반환하고 status Tool로 폴링합니다.
  • 크레딧 부족, 권한 부족, 비동기 작업 실패는 JSON-RPC error.data.reason으로 구분합니다.
  • 삭제, 결제/충전, 실제 외부 배포 실행, binary 파일 처리는 MCP Tool로 제공하지 않습니다.