# Elixir Mcp Server

> Model Context Protocol (MCP) server framework for Elixir/BEAM

- **Type:** MCP server
- **Install:** `agentstack add mcp-hyperpolymath-elixir-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hyperpolymath](https://agentstack.voostack.com/s/hyperpolymath)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MPL-2.0
- **Upstream author:** [hyperpolymath](https://github.com/hyperpolymath)
- **Source:** https://github.com/hyperpolymath/elixir-mcp-server

## Install

```sh
agentstack add mcp-hyperpolymath-elixir-mcp-server
```

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

## About

[](https://elixir-lang.org/)
[](LICENSE) [](https://mcpampel.com/repo/hyperpolymath/elixir-mcp-server)

**Model Context Protocol (MCP) server framework for Elixir/BEAM**

A complete, production-ready implementation of the [Model Context
Protocol](https://modelcontextprotocol.io) that enables Elixir
applications to integrate with Claude Code and other MCP clients.

# Features

- ✅ Complete JSON-RPC 2.0 protocol implementation

- ✅ stdio transport (MCP standard)

- ✅ Tool registration and execution

- ✅ Resource serving (planned)

- ✅ Prompt templates (planned)

- ✅ Server capabilities negotiation

- ✅ Type-safe tool definitions via behaviors

- ✅ OTP supervision for reliability

# Installation

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

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

# Quick Start

## Define a Tool

```elixir
defmodule MyApp.Tools.Echo do
  use ElixirMcpServer.Tool

  @impl true
  def name, do: "echo"

  @impl true
  def description, do: "Echoes back the input message"

  @impl true
  def input_schema do
    %{
      type: "object",
      properties: %{
        message: %{type: "string", description: "Message to echo"}
      },
      required: ["message"]
    }
  end

  @impl true
  def execute(%{"message" => msg}, _context) do
    {:ok, [%{type: "text", text: "Echo: #{msg}"}]}
  end
end
```

## Start the Server

```elixir
ElixirMcpServer.start_link(
  name: "my-app",
  version: "1.0.0",
  tools: [MyApp.Tools.Echo]
)
```

## Configure Claude Code

Add to your `.claude.json`:

```json
{
  "mcpServers": {
    "my-app": {
      "command": "mix",
      "args": ["run", "--no-halt"],
      "env": {}
    }
  }
}
```

# Use Cases

This framework is useful for:

- **feedback-o-tron** - Automated feedback submission with network
  verification

- **Observatory** - GitHub intelligence and issue management

- **NeuroPhone** - Elixir/Phoenix applications

- **Any Elixir service** that wants Claude Code integration

# Architecture

    ┌─────────────────────────────────────┐
    │   MCP Client (Claude Code, etc.)    │
    └─────────────────┬───────────────────┘
                      │ JSON-RPC 2.0 / stdio
    ┌─────────────────▼───────────────────┐
    │    ElixirMcpServer.Server           │
    │    (GenServer, protocol handling)   │
    └─────────────────┬───────────────────┘
                      │
        ┌─────────────┼─────────────┐
        │             │             │
    ┌───▼───┐    ┌───▼────┐   ┌───▼──────┐
    │ Tools │    │Resources│   │ Prompts  │
    │(your) │    │ (your)  │   │  (your)  │
    └───────┘    └─────────┘   └──────────┘

# Documentation

- [API Documentation](https://hexdocs.pm/elixir_mcp_server)

- [Changelog](CHANGELOG.md)

- [Security Policy](SECURITY.md)

# License

MPL-2.0 - see [LICENSE](LICENSE) file for details

# OPSM Link

    OPSM Core
      |
      v
    elixir-mcp-server (Elixir tooling bridge for OPSM)

## Source & license

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

- **Author:** [hyperpolymath](https://github.com/hyperpolymath)
- **Source:** [hyperpolymath/elixir-mcp-server](https://github.com/hyperpolymath/elixir-mcp-server)
- **License:** MPL-2.0

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:** no
- **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-hyperpolymath-elixir-mcp-server
- Seller: https://agentstack.voostack.com/s/hyperpolymath
- 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%.