Skip to content
Agentmart
Submit a tool

Evc Team Relay MCP

MCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.

Connector by entire-vc · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 3
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/entire-vc-evc-team-relay-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

MCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
5 read · 3 write · 1 delete
Secrets
3 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 9

Read from the source code; the running server may list different tools.

Read 5 · Look things up without changing anything.

  • list_files
  • list_shares
  • read_document
  • read_file
  • tr_search

Write 3 · Create, change, send or run things.

  • authenticate
  • upsert_file
  • write_document

Delete 1 · Delete, drop, revoke or wipe things.

  • delete_file

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • RELAY_AGENT_KEY
  • RELAY_AGENT_KEYS
  • RELAY_PASSWORD

Other settings (environment variables or headers).

  • RELAY_CP_URL
  • RELAY_EMAIL

Network hosts it talks to 5

  • cp.tr.entire.vc · found in code
  • cp.yourdomain.com · found in code
  • entire.vc · found in code
  • github.com · found in code
  • glama.ai · found in code

Files it touches

  • /srv
  • Any path the agent passes to its tools

Tools (9)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • authenticate

    Check which auth mode is active (agent key or email/password) and log in if needed. Takes no arguments; call it first, once, before any other tool. In agent-key mode (RELAY_AGENT_KEY or RELAY_AGENT_KEYS is set): no login is needed — each request carries X-Agent-Key directly, this just reports which mode is active. In email/password mode: logs in with the RELAY_EMAIL and RELAY_PASSWORD env vars. The resulting token is managed internally; subsequent tool calls use it automatically — you never need to pass it yourself.

  • delete_file

    Reserved for per-file deletion; not yet available on the server. Always raises: the control-plane has no DELETE route for an individual folder-share file in ANY auth mode (agent-key or JWT) — this isn't a JWT-vs-agent-key gap, per-file deletion simply isn't implemented server-side yet. Note this is independent of the agent-key-only write policy that governs upsert_file: even once/if a delete route lands, it would follow that same policy (agent-key-only, JWT read-only). Args: share_id: UUID of the folder share. file_path: File path within the folder (e.g. "old-note.md").

  • list_files

    List every file in a shared folder with its metadata. Read-only; does not download file contents (use read_file for that). In agent-key mode (RELAY_AGENT_KEYS or RELAY_AGENT_KEY is set): uses the agent-key endpoint; share_id may be a UUID or web slug. In email/password mode: share_id must be a UUID. Args: share_id: UUID or web slug of the folder share, e.g. "a1b2c3d4-..." or "research-vault". Returns: Object with share_id and files map (path -> metadata). The exact set of metadata keys per file is server-controlled, hence the loose dict[str, Any] shape rather than …

  • list_shares

    List the shared folders and documents this key or account can access. Only lists what auth mode/key was granted — it does not create or change access. Example: `list_shares(kind="folder")`. In multi-key mode (RELAY_AGENT_KEYS set): returns metadata for every share that has a configured key, fetched via per-share agent-key auth. RELAY_AGENT_KEYS is typically keyed by share UUID, but the bare share-metadata endpoint (/v1/web/shares/{ref}) only resolves web slugs — a UUID always 404s there. When that happens this falls back to the UUID-addressable files-index endpoint, which proves the share i…

  • read_document

    Reserved for live document content; not yet available on the server, use read_file. Always raises: the control-plane has no REST route for reading a document's live content by ID for either DOC-kind shares or a folder-share file's doc_id (that concept doesn't exist in the current CAS-based folder sync model). This is a genuine backend gap, not an agent-key-vs-JWT restriction. Use read_file for folder shares instead — it works in both agent-key and JWT mode. Args: share_id: UUID of the share (for ACL check). doc_id: Document UUID. Defaults to share_id for doc shares. key: Yjs shar…

  • read_file

    Read one file from a shared folder by its path. Read-only. Returns the full file content in one response — there is no partial/range read. In agent-key mode (RELAY_AGENT_KEY is set): fetches via the agent-key download endpoint; share_id may be a UUID or web slug. In email/password mode: fetches via the same CAS download endpoint used by agent-key mode, over Bearer JWT instead of X-Agent-Key; share_id must be a UUID. Args: share_id: UUID or web slug of the folder share. file_path: File path within the folder (e.g. "Marketing/plan.md"). Returns: {"path", "content", "format"} on …

  • tr_search

    Find files in a shared folder by a case-insensitive match on path or name. Read-only; does not download file contents (use read_file for that). Example: `tr_search(share_id="research-vault", query="roadmap")`. In agent-key mode (RELAY_AGENT_KEY is set): share_id may be UUID or web slug. In email/password mode: share_id must be a UUID. Args: share_id: UUID or web slug of the folder share. query: Search string matched case-insensitively against file paths. limit: Max results to return (default 20). Returns: JSON list of matching files: [{"id": doc_id_or_null, "title": fil…

  • upsert_file

    Create or overwrite a file in a shared folder; it syncs into subscribers' vaults. Agent key only. **Write access is agent-key-only by design** — this is the sanctioned, permanent policy (not a temporary gap): agent-key mode is the only authorized write path in this MCP server. **Agent key mode** (RELAY_AGENT_KEY is set): - share_id may be the share UUID or web slug (e.g. "research-vault") - Folder shares use /sync-upload → file enters the CRDT sync store and appears in subscribers' local Obsidian vaults on the next sync cycle - Doc shares fall back to /upload (web-publish only) - list_file…

  • write_document

    Reserved for live document writes; not yet available on the server, use upsert_file. Always raises: the control-plane has no REST route for writing a document's live content by ID (doc-share content is CRDT/WebSocket-only). This is a genuine backend gap in BOTH agent-key and JWT mode, not an agent-key-vs-JWT restriction — but were a route ever added, per the sanctioned write policy (agent-key writes only) JWT mode would still be read-only. Args: share_id: UUID of the share (for ACL check). doc_id: Document UUID. content: Full text content to write (replaces entire document). …

Signals

Stars
3
Forks
1
Open issues
0
Weekly downloads
77
Last commit
Oct 15, 2026 (13 days ago)
Last release
Sep 23, 2026 (1 month ago)
Last package publish
Sep 23, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.entire-vc/evc-team-relay-mcp
Version
1.0.9
Auth
API key
Packages
pypi evc-team-relay-mcp
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 25, 2026

More from entire-vc

Cite this page

Evc Team Relay MCP. Agent Mart. https://agentmart.dev/connectors/entire-vc-evc-team-relay-mcp (last updated 2026-10-25)