Skip to content

Guides

Connect an AI agent (MCP)

SkedCast runs a remote MCP (Model Context Protocol) server, so an AI agent can read your posts, clients, accounts, analytics, and library — and compose posts — with your permission, over a single OAuth-protected endpoint.

Developer docs

6 min read

Connection

PropertyValue
EndpointPOST https://api.skedcast.com/mcp
TransportStreamable HTTP
AuthOAuth 2.1 bearer token (audience-checked)
Discovery/.well-known/oauth-protected-resource

Add the server to your AI client

Point your MCP-capable client (Claude Desktop, IDEs, agents) at the endpoint below. The client runs the OAuth flow for you — it discovers the authorization server from the protected-resource metadata, registers itself (DCR), and opens a browser for you to sign in and consent. No manual app setup.

{
  "mcpServers": {
    "skedcast": {
      "url": "https://api.skedcast.com/mcp"
    }
  }
}
Example MCP client config.

Available tools

ToolScopeTypeDescription
list_scheduled_postsposts.readreadList the workspace's posts (queue, drafts, published) newest-first, with optional status / client / platform filters.
get_postposts.readreadGet one post with its per-platform variants and fan-out targets.
list_clientsclients.readreadList the workspace's client groups (brands / influencers).
list_accountsaccounts.readreadList connected social accounts, optionally filtered by client or platform.
get_analytics_overviewanalytics.readreadReach / impressions / engagement plus a per-platform rollup over a date window.
list_library_assetsmedia.readreadList content-library (DAM) assets with optional kind / folder / client / search filters.
get_agencyagency.readreadThe current workspace profile — name, plan, app mode, settings, and the caller’s role.
list_reportsreports.readreadList the workspace's saved analytics report definitions.
get_best_timesbesttimes.readreadWorker-derived best posting times (strongest-first), optionally by client / platform.
create_postposts.composewrite ⚠Compose a post and fan it out across the selected accounts (or save it as a draft). A write action — confirm with the user before calling.
import_mediamedia.managewrite ⚠Ingest an external image / video into the content library by URL. A write action — confirm with the user before calling.

Generated from the live MCP catalog — always current.

Discovery URLs

URLPurpose
https://api.skedcast.com/mcpMCP endpoint (POST; GET returns 405)
/.well-known/oauth-protected-resourceResource metadata + scopes (RFC 9728)
/.well-known/oauth-authorization-serverAuthorization-server metadata (RFC 8414)
/.well-known/jwks.jsonPublic keys for token verification
mcpaiclaude

FAQ

Which AI clients can connect?
Any client that speaks the Model Context Protocol over Streamable HTTP with OAuth — including Claude and a growing list of agent frameworks and IDEs.
Can the agent post without my approval?
Read tools run freely within your granted scopes. The write tools (create_post, import_media) are flagged so your MCP host asks you to confirm before they run, and they still can't exceed your role.

Be first in line when SkedCast opens

Join the waitlist — agencies on it get early access and launch-day onboarding.