READ API LIVEBuild on /v1 for search, profiles, timelines, audience graph, and tweet context.READ DOCS
xfetch

Connect xfetch to AI agents.

Hosted remote MCP lets remote-MCP-compatible clients and agents read public X/Twitter data through xfetch workflow tools.

Get an API key →Agent context ↗

Hosted remote MCP

Use the hosted endpoint with Bearer auth during beta.

POST/mcp
beta
Server
server_url: https://api.xfetch.io/mcp
Authorization: Bearer <xfetch_api_key>

Read-only tools

The beta exposes workflow tools, not the full API surface.

search_x_posts

Search recent public posts with deduplicated authors.

lookup_x_profile

Look up a public account profile and recent posts.

get_x_tweet_context

Inspect a post with author, quotes, and retweeters.

get_x_user_timeline

Read recent public posts for an account.

get_x_followers

Read public follower ids or capped profiles.

get_x_following

Read public following ids or capped profiles.

Boundaries

MCP follows normal xfetch read semantics.

  • MCP is read-only.
  • MCP tools consume normal endpoint credits.
  • Failed auth, validation, insufficient credits, rate limits, and service failures do not charge.
  • Pagination uses opaque next_token values.
  • /openapi.json remains the API contract; MCP is the agent tool surface.
  • OAuth is the intended GA connection model after the Bearer beta.