Mastra + X (Twitter)

What is Mastra?

TypeScript framework for building AI agents, workflows, and RAG pipelines with first-class tool calling and MCP support.

Searching X (Twitter) with Mastra

This integration lets your Mastra agent search X (Twitter) in real time via the Scavio API. The agent gets back structured JSON with post snippets, author handles, timestamps, engagement signals — ready for reasoning and decision-making.

Setup

npm install @mastra/core

Code Example

Here is a complete Mastra agent that searches X (Twitter) using Scavio:

# Generic HTTP integration for Mastra
# Use your framework's HTTP request tool to call:
# POST https://api.scavio.dev/api/v1/search
# Header: x-api-key: your_scavio_api_key
# Body: {"query": "your search query"}

Full Working Example

A production-ready example with error handling:

# Generic HTTP integration for Mastra
# Use your framework's HTTP request tool to call:
# POST https://api.scavio.dev/api/v1/search
# Header: x-api-key: your_scavio_api_key
# Body: {"query": "your search query"}

Pricing

Scavio offers a free tier with 500 credits/month (1 credit per search). No credit card required. This is enough to build and test your Mastra integration. Paid plans start at $30/month for higher volumes.