# Mcp Client

> Full-featured Elixir client for the Model Context Protocol (MCP) with multi-transport support, resources, prompts, tools, and telemetry.

- **Type:** MCP server
- **Install:** `agentstack add mcp-nshkrdotcom-mcp-client`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nshkrdotcom](https://agentstack.voostack.com/s/nshkrdotcom)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nshkrdotcom](https://github.com/nshkrdotcom)
- **Source:** https://github.com/nshkrdotcom/mcp_client
- **Website:** https://nshkr.com

## Install

```sh
agentstack add mcp-nshkrdotcom-mcp-client
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Client for Elixir

[](https://elixir-lang.org)
[](https://www.erlang.org)
[](https://hex.pm/packages/mcp_client)
[](https://hexdocs.pm/mcp_client)
[](LICENSE)

> Canonical Model Context Protocol client for the Elixir ecosystem with first-class transports, tooling, and documentation.

## ✨ Highlights

- **Unified transports**: WebSocket, SSE, and raw TCP adapters with shared backoff + tombstone semantics
- **Declarative tools**: Type-safe wrappers for tool declaration, invocation, and validation
- **Observability-first**: Telemetry events for every hop plus structured, redactable logging helpers
- **Production ergonomics**: Configurable retry windows, circuit breakers, and connection watchdogs
- **Docs as product**: ExDoc assets, architecture guides, and SVG branding ship with the library

## 📦 Installation

Add `mcp_client` to your `mix.exs` dependencies:

```elixir
def deps do
  [
    {:mcp_client, "~> 0.1.0"}
  ]
end
```

Then fetch dependencies:

```bash
mix deps.get
```

## 🚀 Quick Start

1. Configure your MCP server credentials in `config/runtime.exs`
2. Start a connection with `McpClient.start_link/1`
3. Declare tools with `McpClient.Tools.declare/1` and register handlers
4. Stream responses with built-in supervision, telemetry, and retries

Full guides and API docs will be published on HexDocs as the project matures.

## 🧪 Development

```bash
mix test
mix credo --strict
MIX_ENV=test mix coveralls.html
```

Dialyzer PLTs live in `priv/plts` (ignored in the Hex package) so shared CI nodes stay fast.

## 🤝 Contributing

Issues and PRs are welcome! Please open a discussion first for sizeable protocol or API changes so we can align on design.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nshkrdotcom](https://github.com/nshkrdotcom)
- **Source:** [nshkrdotcom/mcp_client](https://github.com/nshkrdotcom/mcp_client)
- **License:** MIT
- **Homepage:** https://nshkr.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nshkrdotcom-mcp-client
- Seller: https://agentstack.voostack.com/s/nshkrdotcom
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.