toolnexus (Elixir)

Your LLM, with MCP tools and agent skills built in — in 3 lines, on the BEAM.

toolnexus unifies every tool source an agent needs — MCP servers (stdio + streamable-HTTP), agent skills (SKILL.md folders), your own functions, HTTP endpoints, ten built-in shell/file tools, and remote A2A agents — behind one uniform Tool, emits the schema in OpenAI / Anthropic / Gemini formats, and ships a unified client with a built-in tool-calling loop (hooks, parallel tool calls, retries, conversation memory, suspension/resume, metrics).

It is the Elixir port of toolnexus, byte-identical in behavior with the JS, Python, Go, Java, and C# ports — same config files, same outputs, same wire formats. The MCP client is implemented in-house on OTP (supervised connections, no third-party MCP SDK), which is also why this port ships the full elicitation bridge (form and URL mode).

Install

def deps do
  [{:toolnexus, "~> 0.9"}]
end

Zero to agent

{:ok, toolkit} = Toolnexus.create_toolkit(mcp_config: "mcp.json", skills_dir: ["skills"])
client = Toolnexus.Client.create(base_url: System.get_env("OPENAI_BASE_URL"),
                                 style: "openai", model: "gpt-4.1",
                                 api_key: System.get_env("OPENAI_API_KEY"))
result = Toolnexus.Client.run(client, "What tools do you have? Use one.", toolkit)
IO.puts(result.text)

• mcp.json is the standard Claude-desktop-style config (mcpServers / servers / mcp top-level keys all accepted).
• skills/ is a folder of **/SKILL.md files with YAML frontmatter — loaded on demand through the single skill tool (progressive disclosure).
• Remote MCP headers values expand ${ENV_VAR} at call time and are never logged.

Why the BEAM port

Long-running agents want supervision. Every MCP connection is a supervised process; a crashed stdio server is isolated (status "failed") without taking your toolkit down; parallel tool calls ride Task.async_stream. Same contract as the other five ports, native OTP underneath.

Docs

Full documentation (all six languages, one site): https://muthuishere.github.io/toolnexus/