# Onlypult Developer Documentation

> Publish social media content programmatically, and read social media analytics,
> via REST API and MCP.

## Docs

- Quickstart & Authentication: /dev/index.html
- MCP Server — setup and authentication (HTML): /dev/mcp.html
- MCP publishing tools reference (HTML): /dev/mcp-publishing.html
- MCP analytics tools reference (HTML): /dev/mcp-analytics.html
- Claude.ai Connectors setup: /dev/mcp-claude.html
- ChatGPT Developer mode setup: /dev/mcp-chatgpt.html
- MCP Server — complete reference in one file (Markdown, AI-readable): /dev/mcp.md
- REST API Reference (OpenAPI): /dev/api.html
- OpenAPI spec: /dev/openapi.yaml

The HTML pages are split for human navigation. /dev/mcp.md contains everything —
setup, publishing tools and analytics tools — in a single file; prefer it.

## MCP Server

URL: https://mcp.onlypult.com/mcp
Auth: Bearer op_your_api_key_here (or OAuth 2.1 for Claude.ai / ChatGPT)

Media upload tools:
- media_upload_file — local MCP only (file path on same machine)
- media_get_upload_url + media_check_status — remote MCP / browser upload
- media_urls in posts — public HTTP(S) URL, no upload

Analytics tools (read-only):
- analytics_profiles_list — call first; analytics profile IDs start with an_
- analytics_metrics_list — metric catalog, formulas, per-platform availability
- analytics_overview, analytics_audience, analytics_posts — performance over a period
- analytics_top_posts — rank publications by a metric
- analytics_best_time — weekday x hour engagement heatmap
- analytics_compare_periods — period over period

Analytics profiles are NOT publishing profiles: separate connections, separate IDs
(an_ prefix), no link between them. An id from profiles_list will not work in an
analytics tool, and an an_ id will not work in posts_create.

See /dev/mcp.md for full tool reference.

## REST API

Base URL: https://api.onlypult.com/v1
Auth: Authorization: Bearer op_your_api_key_here

Publishing: /v1/profiles, /v1/posts, /v1/media
Analytics:  /v1/analytics/profiles, /v1/analytics/metrics,
            /v1/analytics/{an_id}/overview|audience|posts|stories|top-posts|best-time|compare