How do I use XSearchLane?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@XSearchLane search for 'AI code review' from last week" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

XSearchLane

by talocode

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

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: twitterapis

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

twitterapi-mcp-server A
io.github.kaitoInfra
Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.
Social Media Search
121
Prowlo — Reddit & X for AI agents A
com.prowlo
Reddit & X data for AI agents over MCP. Semantic search, hosted, no Reddit API.
Social Media Search
492
x-twitter-dataOAuth
com.superagnt
X (Twitter) data for AI agents: tweets, profiles, followers, search, trends + social listening.
Social Media Search
1
Superpowers.social A
social.superpowers
Live X/Twitter and Reddit research. 10 read-only MCP tools, Google/GitHub sign-in. Free tier.
Social Media Search
1021

Related MCP Servers

Twitter MCP
Social Media Communication
isteamhq
A
license
A
quality
C
maintenance
MCP server for Twitter/X enabling AI agents to search, post, reply, and engage with tweets.
Updated 6 days ago (2026-09-14 08:02 UTC)
14
3 npm
2
MIT
twitterapis
Social Media Search
TwitterAPIs
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.
Updated a day ago (2026-09-18 19:23 UTC)
94
984 npm
MIT
X Search One
Search Social Media
brianference
F
license
Not graded
quality
B
maintenance
MCP server that enables searching X (Twitter) via the X API v2, with tools, security model, and install documentation.
Updated 2 months ago (2026-07-10 06:47 UTC)
-
HyperXosist Agent
Search Social Media Product Management
KG-NINJA
A
license
Not graded
quality
B
maintenance
MCP server for noise-reduced X (Twitter) search planning and Feedback-to-Fix engineering handoffs. Enables AI agents to generate structured search plans, filter signals, and build handoff packages via MCP tools.
Updated 8 days ago (2026-09-12 00:38 UTC)
1
MIT

XSearchLane

Why it exists

Architecture

Demo

Install

Quickstart

CLI

MCP (OpenCode)

SDK

Auth / env

API surface

Local engine

Hosted routes (Talocode Cloud)

MCP tools

CLI

Architecture

Develop

Related packages

Talocode ecosystem

Links

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Twitter MCP

twitterapis

X Search One

HyperXosist Agent