---
title: "x-search"
description: "Read-only access to X (Twitter) through the official v2 API. Search posts, look up users, read timelines, and inspect threads."
canonical: https://agentpluginsdirectory.com/plugins/x-search
last-updated: 2026-09-22
---

# x-search
Read-only access to X (Twitter) through the official v2 API. Search posts, look up users, read timelines, and inspect threads.
- Slug: x-search
- Publisher: Matt Palmer
- Repository: https://github.com/mattppal/agent-plugins
- Manifest: plugins/x-search/plugin.json
- Version: 1.0.0
- License: MIT
- Category (editorial): research
- Skills: 1 (x)
- MCP servers: 1 (x-search)
- Stars: 1
- Repository created: 2026-08-06
- Repository last pushed: 2026-08-06
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/x-search
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What x-search does, in the publisher's words

Search and read public X (Twitter) content from your agent. This plugin packages a read-only MCP server for the X API v2, plus a skill that teaches the agent when and how to use each tool. It follows the Agent Plugins Specification v1.0.0.

Read-only means exactly that: the server can search and fetch, but it cannot post, like, repost, follow, or send DMs.

- Node.js 20 or newer. The MCP server runs with node; the client resolves it from your platform's executable search path.
- An X API bearer token. See Authentication below.

The plugin authenticates to the X API with an app-only bearer token:

- Open the X Developer Portal and sign in.
- Create or select a Project and App.
- In the app's Keys and tokens tab, copy (or generate) the Bearer Token.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/mattppal/agent-plugins/HEAD/plugins/x-search/README.md

## Skills

- x: Search and read public X (Twitter) posts, profiles, threads, mentions, quote posts, and Spaces. Use when finding tweets or X posts, looking up accounts, reading timelines, inspecting threads, checking mentions, quote-posts, or live Spaces. Read-only; do not post, like, follow, or DM.

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- x-search: transport: stdio; command: node ${PLUGIN_ROOT}/server/dist/index.js

Read from the plugin's own mcp.json. Environment variable names only, never values.