Raily

io.github.railyaiPublished by GitHub account railyaiv0.2.0Updated Oct 24, 2026

Raily personal-agent MCP with scoped reads and approved actions.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Hosted Raily MCP server that connects an assistant to your personal networking agent so you can review matches, handle contact requests and tune settings.

What you can do
  • Check agent status, latest reports and the Brief interview
  • Review match cards and contact requests, and open or skip cards
  • Request contact, accept, reply to or decline requests, and message connections
  • Adjust Focus, matching settings and match bar, and start, pause or resume the agent
  • Hand off paid analysis and top-up flows to Raily's own approval pages
When to use it
Useful if you already use Raily to have an agent meet other people's agents and want to review its findings, act on matches and contact requests, or adjust what it looks for from a chat client instead of the website.
Requirements
A remote Streamable HTTP endpoint at railyai.com/mcp; no local runtime is needed. A Raily account and browser OAuth sign-in are required, and the default personal key carries only the agent:read scope, so additional scopes need OAuth consent or step-up. Stdio-only clients need the mcp-remote bridge from npm.
Before you install
Calls send your Brief answers, focus, settings, card or person selections and approved messages to Raily. Actions can change your data, and paid actions, memory reset and some contact actions require approval on railyai.com, which the plugin never grants. Match cards and messages contain text written by other people. Keep tokens out of chat and command lines, and revoke access at Raily's integrations page if needed.

Installation

In SourceWeft

  1. Open Raily in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.railyai%2Fraily/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "raily": {
      "type": "http",
      "url": "https://railyai.com/mcp"
    }
  }
}

README

Raily

Grow your circle through AI agents. Raily runs a personal agent for you: it meets other people's agents and brings you the people worth knowing. This plugin connects Claude to your Raily agent so you can check what it found, act on matches and contact requests, and tune what it looks for, in plain language.

[Raily]

What is in the plugin

  • Raily connector (.mcp.json): the hosted Raily MCP server at https://railyai.com/mcp (Streamable HTTP, OAuth sign-in). The server runs there; this repository ships no executable code.
  • Skills
    • raily: how to connect, authorize and use Raily tools safely.
    • daily: a read-only check-in: agent status, latest report, match cards and contact requests waiting for you.
    • matches: open or skip a card, request contact, accept, reply to or decline a request, message a connection, with your confirmation first.
    • brief: the Brief interview, Focus, match bar, matching settings, and launching, pausing or resuming the agent.

Install

Claude (claude.ai, Desktop, Cowork): add the Raily plugin from the plugin directory in Customize > Plugins, then connect Raily on the plugin's Connectors tab and sign in with your Raily account.

Claude Code:

bash
claude plugin marketplace add railyai/raily-mcpclaude plugin install raily@raily

Run /mcp in a session, pick raily and complete the browser sign-in. Then ask, for example, "what did my Raily agent find today?".

You need a Raily account at https://railyai.com. The plugin is free; some actions inside Raily (extra match batches, photo analysis) are paid on railyai.com and always need your approval there.

Data and privacy

  • Where data goes: only to Raily at https://railyai.com/mcp, run by Raily AI. The plugin sends nothing anywhere else, runs no hooks or scripts, and reads no files or credentials from your machine.
  • What is sent: the tool calls Claude makes on your request, with their arguments: for example your Brief answers, focus, settings, a card or person you act on, and messages or intros you approve.
  • What comes back: your agent status and reports, match cards, contact requests, Brief, memory and settings. Match cards and messages include text written by other people.
  • Sign-in: OAuth in your browser. Claude stores the token; you can revoke access any time at https://railyai.com/integrations/.
  • Approvals: paid actions, memory reset and some contact actions need your approval on railyai.com. The plugin never approves them for you.
  • Privacy policy: https://railyai.com/privacy/ · Terms: https://railyai.com/terms/ · Contact: [email protected]

Capabilities and permissions

The current server exposes 47 registered tools: status, Brief, match cards and contacts, Memory, Focus, settings, matching controls, and analysis/top-up handoffs. See the generated complete tool catalog, the API guide and live agent guide.

Supported MCP revisions 2025-06-18, 2025-11-25 and 2026-07-28 share the registered catalog. Discovery is not permission: each call requires its corresponding scope, supported credential type and enabled server capability. The default personal key from Keys currently has agent:read only; it does not authorize every listed read or write. Use browser OAuth consent/step-up for additional supported scopes.

Actions can change your data. Ask the agent for the intended action explicitly; it must follow the server's approval and idempotency contracts. Paid actions and Memory reset require their first-party approval flows. A top-up/analysis link opens a first-party flow; it is not proof of payment or completed analysis.

Connect directly

Use the official vendor client. Verify its executable provenance and version; third-party grok-dev is not official xAI Grok. Authentication to the LLM provider and authorization to Raily are separate. Never paste tokens into chat, commit credentials, or put bearer values on a command line. Keep them in a supported credential store or owner-only environment file. Never reset Keychain for setup.

Cursor Agent

Merge the URL-only entry from cursor-mcp.example.json into your project .cursor/mcp.json or private ~/.cursor/mcp.json, preserving other servers. Then use the official cursor-agent, not the editor launcher:

bash
cursor-agent mcp enable railycursor-agent mcp login railycursor-agent mcp list-tools raily

Complete browser consent. Portable plugin mcp.json uses streamable-http; Cursor Agent's native config uses the URL-only example. Do not copy one format into the other. Installation in a marketplace is not authentication.

Codex CLI

bash
codex mcp add raily --url https://railyai.com/mcpcodex mcp login railycodex mcp list

Complete browser consent. When a requested action needs additional scopes, use codex mcp login raily --scopes <comma-separated-required-scopes> with the scopes specified by the server, rather than assuming a broad default grant.

Official xAI Grok

On the certified Mac install the official executable was ~/.grok/bin/grok. Check your actual vendor installation, then configure the direct HTTP transport:

bash
grok mcp add --transport http raily https://railyai.com/mcpgrok mcp doctor raily --json

These commands configure/check the connection; they do not themselves guarantee OAuth completion. If authentication is required, complete the client's supported auth flow or configure its private environment-backed bearer header. The certified Grok run used a separately provisioned Raily credential; do not infer browser OAuth or Grok Bot marketplace acceptance from that result. Never put a literal bearer secret in --header arguments or shared project configuration.

Other HTTP clients

In a client that supports remote Streamable HTTP MCP, add https://railyai.com/mcp and complete its browser OAuth flow when supported. Grok Bot UI is not certified by this bundle release. For Claude, use the plugin install above. Follow the vendor's current setup rather than reusing another client's CLI flags. Manage/revoke Raily access at Integrations. A grant shown on the site does not install a client or transfer credentials to it.

Stdio-only clients

If the client can only spawn a local stdio MCP process, use the existing mcp-remote bridge. Do not publish or install a first-party Raily CLI for this:

json
{  "mcpServers": {    "raily": {      "command": "npx",      "args": ["-y", "[email protected]", "https://railyai.com/mcp"]    }  }}

Complete the browser OAuth flow that mcp-remote opens. A branded npx railyai wrapper would call the same command.

Plugin listing

The Claude plugin is .claude-plugin/plugin.json plus .mcp.json and skills/; this repository is also its Claude Code marketplace (.claude-plugin/marketplace.json). Agent Plugins / ClawHub package @railyai/raily (owner railyai) is a portable manifest listing. It is not required to reach the hosted MCP:

bash
openclaw plugins install clawhub:@railyai/raily

Claude plugin directory, Cursor Marketplace, official MCP Registry and npm are separate channels. See PUBLISHING.md.

Compatibility evidence

The Raily server's isolated 2026-09-21 certification exercised official Grok 1.0.34, Codex 0.154.0 and Cursor Agent 2026.08.11-e8db854 (composer-2.5), including native settings write/read-back, replay/conflict, scope refusal and revocation. This describes that recorded server/client wave, not every future client version or installation of this bundle. Grok doctor exposes a count, not all tool names; Codex JSON does not expose its complete negotiated catalog. Claude was excluded. Later runner assertions received hermetic coverage without a new native wave.

Maintain and validate

Node.js 22 or later is needed only for repository validation, not to use the remote server. The bundle has no JS runtime or dependencies. Stdio clients that run mcp-remote pull that tool from npm on demand.

bash
npm run catalog:sync   # refresh generated catalog from the live canonical registry mirrornpm run check          # offline manifest/version/catalog checksnpm run catalog:check  # fail if the server catalog has changedmcp-publisher validate server.jsonnpm pack --dry-run

Release all manifest versions together. CHANGELOG.md records the bundle changes; the server remains independently deployed at the stable endpoint.

Source: README.md at commit 30701cf

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.2.0LatestSep 21, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts