Skip to main content
Glama

XSearchLane

Realtime X search for agents.

npm License: MIT

Open-source MCP server, CLI, and SDK that give coding agents live X search — keyword/semantic search, handle filters, date ranges, and citations. Run locally with your upstream key, or use hosted power on Talocode Cloud.

Why it exists

Agents need social signal, not just static web pages. XSearchLane turns realtime X search into a first-class tool surface:

  • MCP-native — plug into OpenCode and other agent hosts

  • Local-first — run the open tool with your own provider key

  • Hosted path — sell/meter usage under /v1/xsearchlane/*

  • Deterministic offline mode — mock provider for tests and CI

Part of Talocode: open tools people trust, hosted power behind them.

Related MCP server: grok-search-mcp

Architecture

XSearchLane Architecture

Agents (OpenCode / CLI / SDK)
        │
        ▼
   XSearchLane core
   runXSearch · runXResearch · MCP
        │
   ┌────┼────────────┐
   ▼    ▼            ▼
  xai  talocode     mock
(direct) (hosted)  (offline)

Demo

XSearchLane demo

Watch the demo: xsearchlane-demo.mp4 (release asset)

# regenerate locally
cd demo && bash make-video.sh

Install

npm install -g @talocode/xsearchlane

Or without install:

npx @talocode/xsearchlane@latest health

Python:

pip install talocode-xsearchlane

Quickstart

CLI

export XAI_API_KEY=...   # direct upstream X search
# or
export TALOCODE_API_KEY=...

xsearchlane search --query "developers complaining about AI code review"
xsearchlane search --query "agent sandbox" --handles simonw,levelsio
xsearchlane research --query "AI coding agent pain points"
xsearchlane health

MCP (OpenCode)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xsearchlane": {
      "type": "local",
      "command": ["npx", "-y", "@talocode/xsearchlane", "mcp"],
      "environment": {
        "XAI_API_KEY": "{env:XAI_API_KEY}"
      }
    }
  }
}

See docs/MCP.md and examples/opencode.json.

SDK

import { runXSearch, XSearchLaneClient } from '@talocode/xsearchlane'

// Local / direct provider
const live = await runXSearch({
  query: 'What are builders saying about agent memory?',
  fromDate: '2026-07-01',
})

// Hosted Talocode Cloud
const client = new XSearchLaneClient({ apiKey: process.env.TALOCODE_API_KEY })
const hosted = await client.search({ query: 'MCP server launch' })

Auth / env

Variable

Purpose

XAI_API_KEY

Direct upstream X search (Responses API x_search)

XAI_BASE_URL

Default https://api.x.ai/v1

XAI_MODEL

Default grok-4.5

TALOCODE_API_KEY

Hosted Talocode API

TALOCODE_BASE_URL

Default https://api.talocode.site

XSEARCHLANE_PROVIDER

auto | xai | talocode | mock

auto picks: xai if XAI_API_KEY is set, else talocode if TALOCODE_API_KEY is set, else mock.

Set XSEARCHLANE_PROVIDER=xapi with X_API_BEARER_TOKEN to use the official API for recent post search, news, trends, and filtered-stream rule inspection. A persistent filtered-stream consumer or webhook receiver is deployment infrastructure and is intentionally not started by the CLI or MCP server.

API surface

Local engine

Function

Description

runXSearch(options)

Realtime X search

runXResearch(options)

Research-style brief

health()

Provider status

getPricing() / getCapabilities()

Metadata

Hosted routes (Talocode Cloud)

Method

Path

Credits

GET

/v1/xsearchlane/health

0

GET

/v1/xsearchlane/pricing

0

GET

/v1/xsearchlane/capabilities

0

POST

/v1/xsearchlane/search

15

POST

/v1/xsearchlane/research

40

Auth:

Authorization: Bearer $TALOCODE_API_KEY

MCP tools

Tool

Description

xsearchlane_search

Live X search + filters

xsearchlane_research

Theme/pain-point research brief

xsearchlane_health

Health + active provider

xsearchlane_capabilities

Feature matrix

xsearchlane_pricing

Credit table

CLI

xsearchlane search --query "..." [--handles a,b] [--exclude c] [--from YYYY-MM-DD] [--to YYYY-MM-DD]
xsearchlane research --query "..."
xsearchlane health | pricing | capabilities
xsearchlane mcp

Architecture

Agent (OpenCode / CLI / SDK)
        │
        ▼
   XSearchLane
   ┌──────────────────────────┐
   │ MCP · CLI · SDK · HTTP   │
   └────────────┬─────────────┘
                │
     ┌──────────┼──────────┐
     ▼          ▼          ▼
   xai       talocode     mock
 (direct)   (hosted)   (offline)

Develop

git clone https://github.com/talocode/xsearchlane
cd xsearchlane
npm install
npm run build
npm test
npm run mcp

Package

Install

XSearchLane (this package)

npm i @talocode/xsearchlane · pip install talocode-xsearchlane

XProLane

npm i @talocode/xprolane · pip install talocode-xprolane

SearchLane

npm i @talocode/searchlane · pip install talocode-searchlane

StackLane

pip install talocode

Talocode ecosystem

Product

Repo

Notes

XSearchLane

talocode/xsearchlane

(this package) realtime X search MCP/API

XProLane

talocode/xprolane

X Pro setup & signal dashboard planner

SearchLane

talocode/searchlane

Agent web search & research

Tera

talocode/tera

Hosted writing/coding capability API

Codra

talocode/codra

Coding agent runtime

StackLane

talocode/stacklane

Cloud control plane, keys, wallet

GateLane

talocode/gatelane

Policy / gate tooling

ContextLane

talocode/contextlane

Context infrastructure

ScreenLane

talocode/screenlane

Screen/agent UI tooling

MemoryLane

talocode/memorylane

Memory for agents

Tradia

talocode/tradia

Trading tooling

DevTool

talocode/devtool

Developer utilities

Agent Browser

talocode/agent-browser

Browser automation API

InvoiceLane

talocode/invoicelane

Invoicing

GeoLane

talocode/geolane

Geo visibility

ClipLoop

talocode/cliploop

Short-form video loop

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT © Talocode

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    B
    maintenance
    MCP server that enables coding agents to search X/Twitter and the web through the local Grok CLI, providing better search results than default Codex or Claude search without requiring an API key.
    36
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    MCP server for the Twitter/X read API, enabling search, user profiles, tweets, followers, and more via natural language.
    37
    376
    MIT
  • F
    license
    -
    quality
    B
    maintenance
    MCP server that enables searching X (Twitter) via the X API v2, with tools, security model, and install documentation.

View all related MCP servers

Related MCP Connectors

  • Reddit & X data for AI agents over MCP. Semantic search, hosted, no Reddit API.

  • Hosted MCP for X/Twitter and Reddit. 12 read-only tools, no API keys, free during beta.

  • Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/talocode/xsearchlane'

If you have feedback or need assistance with the MCP directory API, please join our Discord server