Connect the X API
Integrate the X API through Modiva’s unified REST API and hosted MCP server. Post, thread, search and read mentions. OAuth, token refresh, rate limits and 14 typed tools are handled for you — connect once and call X from any agent or app through a single endpoint.
What you can do with the X API
- ✓ Publishing
- ✓ Scheduling
- ✓ Inbox & DMs
- ✓ Analytics
- ✓ Webhooks
X MCP tools & scopes
- accounts_
- list · health · status
- posts_
- create · cross_post · schedule · publish_now
- comments_
- list · reply
- messages_
- list · send · inbox
- analytics_
- unified · best_time_to_post
OAuth scopes requested
- Read profile & accounts
- Publish posts & stories
- Read insights
- Read & reply to comments/DMs
Connect X in your agent
# Add Modiva's MCP server to your agent
{
"mcpServers": {
"modiva": {
"url": "https://mcp.modiva.ai",
"headers": { "Authorization": "Bearer $MODIVA_MCP_KEY" }
}
}
}
# Then connect X and call its tools, e.g.
accounts_list(provider="x")Frequently asked questions
How do I connect the X API with Modiva?
Create a Modiva account, generate an MCP key, and connect X from your dashboard. Modiva runs the full OAuth flow and stores the encrypted token for you — no client secrets in your code.
What can I do with the X API through Modiva?
Post, thread, search and read mentions. You get 14 typed tools grouped by resource (accounts_, posts_, comments_, messages_, analytics_), callable over REST or the MCP server.
Do I need to handle OAuth or token refresh myself?
No. Modiva handles the X OAuth handshake, token storage (envelope-encrypted) and automatic refresh. You call a single unified endpoint.
Can an AI agent use the X API?
Yes — that is the point. Modiva exposes X as Model Context Protocol (MCP) tools, so agents like Claude, Cursor or your own app can read and act on X through one endpoint.
X playbooks & guides
Free, step-by-step playbooks on growing with X — what works, plus how to run it with Modiva.