Skip to main content
Glama

smith-charts-mcp

M8ven Score

A lightweight Model Context Protocol server for RF & microwave engineering, built around the Smith chart.

Give Claude, Cursor or any MCP client the ability to convert impedances, analyze transmission lines and ladder circuits, synthesize L / Pi / T / stub / λ/4 matching networks, analyze transistor S-parameters (stability, gain, noise, conjugate match) and draw publication-quality Smith charts — with human-readable summaries in English or Turkish.

Türkçe README

  • 14 tools · 7 prompts · 8 resources

  • Runs anywhere: local stdio, or as a remote Streamable HTTP server at /mcp. That lets you add it as a custom connector in Claude on web, desktop and mobile.

  • Lightweight: 2 runtime dependencies (@modelcontextprotocol/sdk, zod) + optional @resvg/resvg-js for PNG. No browser, no web framework, no database.

  • Engineer-friendly input: "2.4GHz", "10nH", "1.5pF", "4k7", "25-j15", "0.25λ", "45deg", "12mm".

  • Chainable: every matching tool returns components in the exact format analyze_circuit and render_smith_chart accept. Design, verify and plot in three calls.

  • Verified math: 66 tests, including textbook examples (Pozar). Every synthesized network is re-simulated before it is returned.


Installation

Hosted endpoint (no install, works on mobile)

Add https://smith-charts-mcp.technowide.software/mcp as a custom connector:

  • Claude (web, desktop, iOS, Android): Settings → Connectors → Add custom connector.

  • Any other client that supports remote Streamable HTTP MCP servers.

The hosted server always runs the latest release. Ask it version_info to see what changed.

Local (stdio)

Requires Node.js ≥ 20.

Claude Code

claude mcp add smith-charts -- npx -y smith-charts-mcp

Claude Desktop / Cursor / Windsurf / VS Code

Add the server to your MCP config (claude_desktop_config.json, .cursor/mcp.json, …):

{
  "mcpServers": {
    "smith-charts": {
      "command": "npx",
      "args": ["-y", "smith-charts-mcp"],
      "env": { "SMITH_CHARTS_MCP_LANG": "en" }
    }
  }
}

From source

git clone https://github.com/furkanmeclis/smith-charts-mcp.git
cd smith-charts-mcp
npm install
npm run build

Then point your client at node /absolute/path/to/smith-charts-mcp/dist/index.js.

Inspect it interactively with npm run inspect, which opens the MCP Inspector.

Remote server (Claude mobile, web and other devices)

Run the Streamable HTTP transport and put it behind HTTPS:

npm run build
PORT=3000 node dist/index.js --http          # → http://0.0.0.0:3000/mcp
# or with Docker
docker build -t smith-charts-mcp .
docker run -d -p 3000:3000 --restart unless-stopped smith-charts-mcp

Expose it through your reverse proxy, e.g. https://smith-chart-mcp.example.com/mcp. Then in Claude go to Settings → Connectors → Add custom connector and paste that URL. The connector then works in the mobile apps as well.

What the HTTP mode provides:

  • Stateless: each request is self-contained, so you can run as many replicas as you like.

  • Endpoints:

    • GET /health: liveness check.

    • GET /: info page.

    • POST /mcp: the MCP endpoint.

    • CORS is enabled.

  • Protection: per-IP rate limit (RATE_LIMIT_PER_MINUTE, default 120) and a 4 MB body limit.

  • No filesystem access: touchstone_path and output_path are disabled, so clients cannot read or write files on your server. Pass Touchstone data as touchstone_content instead. Set SMITH_CHARTS_MCP_ALLOW_FS=1 only on a private deployment.

  • Docker image: includes the DejaVu fonts, so PNG labels render correctly on Linux.


Related MCP server: spicelib-mcp

Tools

Tool

What it does

impedance_convert

Converts Z, z, Y, Γ, VSWR or return loss into all the others: VSWR, return/mismatch loss, Q, and equivalent series/parallel L or C at a frequency.

tline_input_impedance

Zin of a lossy or lossless line with an electrical or physical length (εeff / velocity factor), Γ at load and input, and the positions of the voltage maxima and minima.

analyze_circuit

Cascades load → components → source. Returns Z, Γ and VSWR at every node, a frequency sweep, matched bandwidth and tolerance-corner analysis.

design_l_match

All L-section solutions, including complex source and load. Classifies each as low-pass or high-pass and reports DC behaviour, bandwidth and E-series rounding.

design_pi_t_match

Pi and T networks for a chosen loaded Q, with every low-pass, high-pass and mixed variant.

design_stub_match

Single-stub tuner (open or short, shunt or series), with lengths in λ, degrees and metres.

design_quarter_wave

λ/4 transformer. Complex loads are first rotated to the nearest voltage maximum or minimum.

parse_touchstone

Summarizes a .s1p or .s2p file (MA/DB/RI): per-frequency table, best match, K/μ, MAG/MSG, stable ranges and noise data.

amplifier_stability

Rollett K, |Δ|, μ and μ', plus source and load stability circles with their stable side. Can sweep a whole file.

gain_circles

Available, operating and unilateral constant-gain circles, with MAG/MSG or G_S,max / G_L,max as reference.

noise_circles

Constant noise-figure circles; also evaluates NF and available gain for a proposed source impedance.

conjugate_match

Simultaneous conjugate match: ΓS, ΓL, GT,max, MSG and U, plus ready-made input and output L-networks.

version_info

Running version, release notes for any version, and "what changed since X". Also reports runtime capabilities.

render_smith_chart

PNG/SVG Smith chart with impedance, admittance or combined grid and light or dark theme. Overlays include circuit arcs, sweeps, points, VSWR/Q circles, any circle, a Touchstone S11 locus, and amplifier stability (shaded), gain and noise circles. Can also save the image to a file.

All tools accept language: "en" | "tr". Results come back as a readable summary plus the full numeric JSON, which is also exposed as structuredContent.

Circuit format

Components are listed from the load towards the source:

{
  "load": { "z": "25-j15" },
  "frequency": "2.4GHz",
  "components": [
    { "type": "capacitor", "placement": "series", "value": "6.63pF" },
    { "type": "inductor",  "placement": "shunt",  "value": "3.32nH", "q": 40 }
  ],
  "sweep": { "span": "800MHz" },
  "bandwidth_vswr": 2
}

Element types:

  • inductor, capacitor, resistor: support Q, ESR, ESL and tolerance.

  • rlc: series or parallel combination.

  • impedance: constant Z or a Z(f) table.

  • transmission_line: lossy, with εeff or velocity factor.

  • stub: open or short, shunt or series.

  • transformer and coupled_inductors.

The load can be a constant z, a gamma, a table, or a measured .s1p file (touchstone_path), for example a VNA sweep of an antenna.

Prompts

Prompt

Workflow

match_impedance

Analyze the load, then design and compare every matching method, verify the best one, and plot it.

design_amplifier

From an .s2p file: stability, then the max-gain / low-noise / target-gain trade-off, then input and output networks.

check_stability

Stability report over frequency, with shaded stability circles.

tune_antenna

Tune a measured .s1p antenna at a target frequency and report the achieved bandwidth.

explain_smith_chart

Interactive Smith chart lesson (beginner, intermediate or advanced) with practice problems.

solve_rf_problem

Step-by-step homework solution, with every number cross-checked by the tools.

transmission_line_problem

Zin, standing waves and voltage maxima and minima for a terminated line.

Every prompt takes a language argument (en / tr).

Resources

  • smith://docs/formulas.en.md, smith://docs/formulas.tr.md: formula sheet covering reflection, transmission lines, matching, stability, gain and noise.

  • smith://docs/components.en.md, smith://docs/components.tr.md: circuit input format.

  • smith://changelog.en.md, smith://changelog.tr.md: release history.

  • smith://examples/bjt-100m-2g.s2p, smith://examples/lna-1g4-noise.s2p: example devices to experiment with.

Example conversation

You: Match a 25 − j15 Ω load to 50 Ω at 2.4 GHz. I need a DC block and standard E24 parts, and show me the Smith chart.

Claude calls design_l_match (preference dc_block, snap_to_series: "E24"), then analyze_circuit with a sweep, then render_smith_chart. It answers with: series C 6.63 pF → shunt L 3.32 nH (E24 parts: 6.8 pF and 3.3 nH give VSWR 1.01 at 2.4 GHz). VSWR stays ≤ 2 from about 1.5 GHz to beyond 4.6 GHz, plus the chart above.

Configuration

Variable

Default

Meaning

SMITH_CHARTS_MCP_LANG

en

Default summary language (en or tr) when a call does not pass language.

MCP_TRANSPORT

stdio

Set to http to start the Streamable HTTP server (same as --http).

PORT / HOST / MCP_PATH

3000 / 0.0.0.0 / /mcp

HTTP listen settings.

RATE_LIMIT_PER_MINUTE

120

HTTP requests per minute per client IP (0 disables the limit).

SMITH_CHARTS_MCP_ALLOW_FS

off

Allow touchstone_path / output_path over HTTP. Enable only on trusted, private deployments.

SMITH_CHARTS_MCP_FONT, SMITH_CHARTS_MCP_FONT_DIRS

auto

Font family and extra font directories used for PNG text.

PNG output uses the optional @resvg/resvg-js dependency. If it is unavailable, render_smith_chart returns SVG instead.

Every chart carries two marks:

  • a faint furkanmeclis/smith-charts-mcp watermark;

  • a QR code in the free bottom-right corner that links to this repository.

The QR is pre-generated at build time, so it adds no runtime dependency. To regenerate it for a fork, run npm run gen:qr -- <url>.

Development

npm install
npm test          # node --test, runs the TypeScript sources directly (Node ≥ 22.18)
npm run typecheck
npm run build     # → dist/
npm run dev       # run the server from source (stdio)
npm run dev:http  # … or over HTTP on :3000/mcp

The project layout:

  • src/core: pure math, no MCP dependency.

  • src/render: SVG and PNG chart rendering.

  • src/tools: MCP tool definitions.

  • src/prompts and src/resources.

Versioning & releases

The project follows Semantic Versioning. Release notes live in CHANGELOG.md and inside the server itself: ask "which version are you and what changed?" and the model calls version_info.

Pushing a vX.Y.Z tag runs the release workflow, which:

  • verifies the version and runs the tests;

  • publishes the GitHub release;

  • publishes the multi-arch image ghcr.io/furkanmeclis/smith-charts-mcp;

  • redeploys the hosted endpoint.

See CONTRIBUTING.md for the full release steps.

Contributing

Issues and pull requests are welcome, in English or Turkish. Read CONTRIBUTING.md and the Code of Conduct first. Report security issues privately as described in SECURITY.md.

License

MIT © Furkan Meclis

Available Tools

14 tools
amplifier_stabilityTwo-port (amplifier) stability analysisA
Read-onlyIdempotent

Rollett stability factor K, |Δ|, Edwards-Sinsky μ (load) and μ' (source), unconditional-stability verdict and the input (source-plane) and output (load-plane) stability circles with their stable side. With a Touchstone file and no frequency, returns a K/μ table over the whole file and the stable frequency ranges. Use before designing any amplifier matching network to know which source/load impedances are safe.

Inputs: device (required), language, frequency.

analyze_circuitAnalyze a ladder / matching circuitA
Read-onlyIdempotent

Analyze a cascaded RF circuit (load → components → source) the way a Smith chart does: returns the impedance, Γ and VSWR at every node, the final input impedance with return/mismatch loss, an optional frequency sweep (S11 in dB, VSWR vs. frequency), matched bandwidth for a VSWR limit, and Monte-Carlo-free tolerance corner analysis (± tolerance_pct on each component). Supported elements: inductor, capacitor, resistor (series or shunt, with Q/ESR/ESL), series/parallel RLC, custom impedance or Z(f) table, transmission line (lossy, εeff/velocity factor), open/short stubs (shunt or series), ideal transformer and coupled inductors. The load may be a constant Z, a Γ, a Z(f) table or a measured .s1p file (antenna). Use to verify a matching network, check an antenna tuner, or answer 'what impedance does the source see?'.

Inputs: load (required), frequency (required), z0, sweep, +3 more.

conjugate_matchSimultaneous conjugate match & maximum gainA
Read-onlyIdempotent

Simultaneous conjugate match of a two-port for maximum transducer gain: ΓS and ΓL (and the impedances ZS, ZL the matching networks must present to the device), GT,max (= MAG), MSG, unilateral figure of merit U and the unilateral gain error bounds. Requires K > 1 and |Δ| < 1. With design_networks=true it also synthesizes L-section input and output matching networks from the system Z0 (verified by recomputing ΓS/ΓL).

Inputs: device (required), language, frequency, design_networks.

design_l_matchDesign L-section matching networksA
Read-onlyIdempotent

Synthesize every two-element lumped L-network (series/shunt L and C) that matches a load to a source at one frequency. Handles complex loads and complex sources (conjugate match). Returns 2–4 solutions with exact component values, low-pass/high-pass classification, DC-block/DC-feed behaviour, verified input impedance and VSWR, matched bandwidth, and optional rounding to standard E12/E24/E96 values. Elements are listed load → source and can be passed directly to analyze_circuit or render_smith_chart. Use for 'match 25-j15 Ω to 50 Ω at 2.4 GHz'.

Inputs: load (required), frequency (required), z0, source, +4 more.

design_pi_t_matchDesign Pi / T matching networks with a target QA
Read-onlyIdempotent

Synthesize three-element Pi (shunt-series-shunt) or T (series-shunt-series) lumped matching networks for a chosen loaded Q, giving control over bandwidth/harmonic suppression that an L-network cannot. Q must exceed √(Rhigh/Rlow − 1). Returns all low-pass/high-pass/mixed variants with component values, virtual resistance, verification and bandwidth. Use for PA output networks, harmonic filtering, or 'match 10 Ω to 50 Ω with Q = 5'.

Inputs: q (required), load (required), frequency (required), z0, +6 more.

design_quarter_waveDesign a quarter-wave (λ/4) transformerA
Read-onlyIdempotent

Design a λ/4 impedance transformer Z1 = √(Z0·R). Real loads are matched directly; complex loads first get a section of Z0 line that rotates them to the nearest voltage maximum (R = Z0·VSWR) or minimum (R = Z0/VSWR) on the real axis. Returns the offset length, transformer impedance, physical lengths (if frequency is given), verification and matched bandwidth. Elements are listed load → source.

Inputs: load (required), z0, source, eps_eff, +4 more.

design_stub_matchDesign single-stub matching (distributed)A
Read-onlyIdempotent

Single-stub tuner design (Pozar §5.2): find the distance d from the load along the main line and the length ℓ of an open- or short-circuited stub (shunt or series) that matches the load to Z0. Returns all solutions in wavelengths, degrees and — when frequency is given — physical length (with eps_eff / velocity_factor), plus verification and matched bandwidth. Components are returned load → source for analyze_circuit / render_smith_chart. Use for microstrip/coax stub tuners and textbook Smith chart stub problems.

Inputs: load (required), z0, source, eps_eff, +7 more.

gain_circlesConstant-gain circlesA
Read-onlyIdempotent

Constant-gain circles for amplifier design (Pozar ch. 12): 'available' (G_A, source plane, bilateral), 'operating' (G_P, load plane, bilateral), 'unilateral_source' (G_S) or 'unilateral_load' (G_L) for S12≈0 designs. Returns centre (Γ and Z), radius and whether each gain is achievable, plus the reference maximum gain (MAG/MSG or G_S,max/G_L,max). Omit gains_db to get a ladder of circles below the maximum. Pass the circles to render_smith_chart to plot them.

Inputs: device (required), type, gains_db, language, +1 more.

impedance_convertImpedance / admittance / reflection-coefficient converterA
Read-onlyIdempotent

Convert one RF quantity into all the others for a reference impedance Z0: impedance Z ↔ normalized z ↔ admittance Y ↔ reflection coefficient Γ (S11), plus VSWR, return loss, mismatch loss, delivered power and Q. Give exactly ONE of: z, z_normalized, y, gamma, or vswr (+ optional gamma_angle_deg). With a frequency, also returns the equivalent series and parallel R + L/C element values. Use for: 'what is the VSWR of 75 Ω on 50 Ω?', 'convert S11 = 0.5∠30° to impedance', 'return loss of 25-j15 Ω'.

Inputs: y, z, z0, vswr, +6 more.

noise_circlesConstant noise-figure circles (LNA design)A
Read-onlyIdempotent

Constant noise-figure circles in the source (ΓS) plane from the noise parameters NFmin, Γopt and Rn — taken from a .s2p noise block (interpolated at frequency) or given explicitly. Optionally evaluates the noise figure for a proposed source impedance/Γ and, if S-parameters are available, the available gain at Γopt (gain/noise trade-off). Use for low-noise amplifier (LNA) input matching.

Inputs: rn, z0, nf_db, device, +6 more.

parse_touchstoneParse & summarize a Touchstone (.s1p / .s2p) fileA
Read-onlyIdempotent

Read a Touchstone v1 S-parameter file (from a VNA, simulator or datasheet) and summarize it: port count, reference impedance, frequency range, per-frequency table (S11/S21/S12/S22 in dB and angle, VSWR, input impedance, and for 2-ports K, μ and MAG/MSG), resonance / best match for 1-ports, unconditionally stable ranges for 2-ports, and noise parameters if present. Supports MA/DB/RI formats and any frequency unit.

Inputs: language, max_rows, touchstone_path, touchstone_content.

render_smith_chartRender a Smith chart (PNG / SVG)A
Idempotent

Draw a publication-quality Smith chart and return it as an image (PNG, via resvg) and/or SVG. Layers (all optional, combine freely): a circuit (load + components listed load → source) drawn as the classic constant-R / constant-G / transmission-line arcs with a node marker per component, plus an optional frequency-sweep trace of the input; impedance or Γ points; VSWR circles; constant-Q contours; arbitrary circles (e.g. from gain_circles / noise_circles / amplifier_stability, centre given as Γ); an S11/S22 locus from a Touchstone file; and amplifier overlays computed from a device (stability circles with the unstable side shaded, available/operating gain circles, noise-figure circles). Impedance, admittance or combined grid; light or dark theme; optional output_path to also save the file.

Inputs: z0, grid, size, theme, +12 more.

tline_input_impedanceTransmission line input impedanceA
Read-onlyIdempotent

Input impedance of a (lossy or lossless) transmission line terminated in a load: Zin = Z0·(ZL + Z0·tanh γℓ)/(Z0 + ZL·tanh γℓ). Length can be electrical (λ, degrees) or physical (mm, m, mil) with eps_eff / velocity_factor. Also returns Γ at load and input, electrical/physical length, guided wavelength, and the distances from the load to the first voltage maximum and minimum. Use for coax/microstrip/λ/4/λ/2 line questions and 'where is the voltage minimum?' problems.

Inputs: length (required), z0, load, eps_eff, +7 more.

version_infoServer version & changelogA
Read-onlyIdempotent

Report which version of smith-charts-mcp is running and what changed between versions. Without arguments: current version, release date and its release notes. version: notes of one specific release. since: every change released after that version (e.g. 'what changed since 0.1.0?'). all: the full history. Also reports runtime capabilities (PNG rendering, filesystem access).

Inputs: all, since, version, language.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes by topology or analysis type (L vs Pi/T vs stub vs quarter-wave; stability vs gain vs noise circles). Some overlap exists: conjugate_match can also synthesize L-section matching networks, and analyze_circuit overlaps with tline_input_impedance for line calculations, though descriptions clarify primary use cases.

    Naming Consistency4/5

    All names use snake_case and are descriptive, but the set mixes verb_noun (design_l_match, analyze_circuit, render_smith_chart) with noun_noun/noun_verb patterns (gain_circles, impedance_convert, tline_input_impedance). The inconsistency is minor and readable, not chaotic.

    Tool Count5/5

    14 tools fit the RF/Smith-chart domain well; each tool covers a distinct design, analysis, or rendering task without obvious filler. The count is within the well-scoped range and proportional to the breadth of the domain.

    Completeness4/5

    The surface covers common matching topologies (L, Pi/T, stub, quarter-wave), circuit/line analysis, Touchstone parsing, amplifier stability/gain/noise, and Smith chart rendering. Minor gaps remain, such as multi-section/optimization workflows or circuit-to-S-parameter export, but core workflows are covered.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for rftools.io — 213 RF & electronics calculators + 13 server-side simulation tools for AI agents. Give Claude, Cursor, or any MCP-compatible AI assistant access to validated engineering calculators and heavy server-side simulations. Microstrip impedance, link budgets, filter design, converter sizing, antenna patterns, and 190+ more calculators — plus NEC2 antenna simulation, FDTD, Mon
      1,472 npm
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A thin MCP server that wraps spicelib for circuit simulation. Exposes tools for running AC, transient, DC op, and parameter sweep analyses, enabling behavioral model fitting through iterative simulation and measurement comparison.
      4
      8
      GPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP-compatible agents to generate Qucs circuit schematics, run simulations, and parse results programmatically.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to design RF filters and SMPS-EMC from spec using three MCP servers that drive LTspice, Qucs-S, and scikit-rf, with closed-form synthesis, real-component optimization, and CISPR-aware compliance checking.
      4
      AGPL 3.0