How do I use XSearchLane?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

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

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

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
https://mcp.twitterapi.io/mcp
X (Twitter) MCP by InsightfulPipe A
com.insightfulpipe
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Social Media Communication
41
https://x-organic.insightfulmcp.com/
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
2
https://api.prowlo.com/mcp
Mamitsu MCP A
com.usemamitsu
OAuth-enabled MCP server that extracts structured data from public social media posts.
Social Media Web Scraping
11
https://usemamitsu.com/mcp

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 2 months ago (2026-09-14 08:02 UTC)
14
3 npm
2
MIT
twitterapis
Search Social Media
TwitterAPIs
A
license
A
quality
A
maintenance
MCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.
Updated 3 days ago (2026-11-01 21:59 UTC)
94
464 npm
5
MIT
X Search One
Search Social Media
brianference
F
license
Not graded
quality
C
maintenance
MCP server that enables searching X (Twitter) via the X API v2, with tools, security model, and install documentation.
Updated 4 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 14 days ago (2026-10-21 15:11 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