# Modiva

> One endpoint, every social API your agent needs. A REST API + hosted MCP
> server to post, schedule and analyze across social platforms and ad networks.

## Endpoints
- REST API: https://modiva.ai/api/v1
- OpenAPI: https://modiva.ai/openapi.json
- Hosted MCP: https://mcp.modiva.ai/v1
- OAuth metadata: https://modiva.ai/.well-known/oauth-authorization-server

## Auth
Send `Authorization: Bearer <mcp_key>` (create one in the dashboard) or an
OAuth 2.1 access token.

## Rate limits
Per-org limits scale with connected accounts. Every response carries
`X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`; a 429
adds `Retry-After`. Analytics endpoints use a tighter 1-second window.
- up to 2 accounts: 60 req/min (analytics 2 req/s)
- up to 2000 accounts: 600 req/min (analytics 10 req/s)
- 2001+ accounts: 1200 req/min (analytics 20 req/s)

## SDKs (hand-written, open source — github.com/modiva-dev)
- Node.js: npm i @modiva/node
- Python: pip install modiva
- Go: go get modiva.ai/go
- Ruby: gem install modiva
- Java: ai.modiva:sdk
- PHP: composer require modiva/sdk
- .NET: dotnet add package Modiva
- Rust: cargo add modiva
- Chat adapter: npm i @modiva/chat-adapter (one handler across IG/Messenger/WhatsApp/Telegram/X/Discord)
- CLI: npm i -g modiva

## Webhooks (outbound, to your endpoint)
Register an endpoint in the dashboard or via POST https://modiva.ai/api/webhook-endpoints.
Deliveries are signed: `Modiva-Signature: t=<unix>,v1=<hmac_sha256>` over "{t}.{body}".
Events: post.published, post.failed, message.received, comment.received,
connection.authorized, connection.revoked, connection.error, analytics.updated.

## Live integrations
Mock Integration, Stripe, Bluesky, Telegram, Discord, Mastodon, Instagram, Facebook, Threads, WhatsApp

## Core tools
- posts_create / posts_schedule — publish or schedule content
- comments_list / comments_reply — read & reply to comments
- messages_list / messages_reply — read & send DMs
- analytics_account / analytics_post — insights
- connect_get_connect_url — hosted OAuth for your users
- Generic: GET https://modiva.ai/api/v1/tools, POST https://modiva.ai/api/v1/tools/{integration}/{tool}

## Community
- GitHub: https://github.com/modiva-dev
- Discord: https://discord.gg/modiva
- Telegram: https://t.me/modiva

## Guides & Playbooks
Free, step-by-step guides on growing across social platforms — what works, and how to run it with Modiva.
- Index: https://modiva.ai/playbooks
- How to go viral on TikTok: https://modiva.ai/playbooks/how-to-go-viral-on-tiktok
- Instagram Reels content ideas: https://modiva.ai/playbooks/instagram-reels-content-ideas
- How to grow on LinkedIn: https://modiva.ai/playbooks/how-to-grow-on-linkedin
- YouTube Shorts strategy: https://modiva.ai/playbooks/youtube-shorts-strategy
- How to cross-post to every platform: https://modiva.ai/playbooks/how-to-cross-post-to-every-platform
- Build a social media content calendar: https://modiva.ai/playbooks/social-media-content-calendar
- Repurpose one video into 10 posts: https://modiva.ai/playbooks/how-to-repurpose-one-video-into-ten-posts
- Automate social media with AI agents (MCP): https://modiva.ai/playbooks/automate-social-media-with-ai-agents
- Pinterest marketing strategy: https://modiva.ai/playbooks/pinterest-marketing-strategy
- How to grow on X (Twitter): https://modiva.ai/playbooks/how-to-grow-on-x-twitter

## Solutions
How Modiva fits different teams and use cases.
- Index: https://modiva.ai/solutions
- Modiva for agencies: https://modiva.ai/solutions/for-agencies
- Modiva for creators: https://modiva.ai/solutions/for-creators
- Modiva for startups: https://modiva.ai/solutions/for-startups
- Modiva for ecommerce: https://modiva.ai/solutions/for-ecommerce
- Modiva for SaaS: https://modiva.ai/solutions/for-saas-companies
- Modiva for marketing teams: https://modiva.ai/solutions/for-marketing-teams
- Modiva for social media managers: https://modiva.ai/solutions/for-social-media-managers
- Social media API for developers: https://modiva.ai/solutions/for-developers
- Social media for AI agents (MCP): https://modiva.ai/solutions/for-ai-agents
- Modiva for enterprises: https://modiva.ai/solutions/for-enterprises
- Modiva for nonprofits: https://modiva.ai/solutions/for-nonprofits
- Modiva for media & newsletters: https://modiva.ai/solutions/for-newsletters-and-media

## Glossary
Plain-English explainers for the concepts behind Modiva.
- Index: https://modiva.ai/glossary
- What is an MCP server?: https://modiva.ai/glossary/what-is-an-mcp-server
- What is the Model Context Protocol?: https://modiva.ai/glossary/what-is-the-model-context-protocol
- What is a social media API?: https://modiva.ai/glossary/what-is-a-social-media-api
- What is a unified API?: https://modiva.ai/glossary/what-is-a-unified-api
- What is social media automation?: https://modiva.ai/glossary/what-is-social-media-automation
- What is cross-posting?: https://modiva.ai/glossary/what-is-cross-posting
- What is a content calendar?: https://modiva.ai/glossary/what-is-a-social-media-content-calendar
- What is an ads API?: https://modiva.ai/glossary/what-is-an-ads-api
- What is OAuth?: https://modiva.ai/glossary/what-is-oauth
- What is a webhook?: https://modiva.ai/glossary/what-is-a-webhook
- What is an API access token?: https://modiva.ai/glossary/what-is-an-api-access-token
- What is a social media scheduler?: https://modiva.ai/glossary/what-is-a-social-media-scheduler