smith-charts-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@smith-charts-mcp Design an L-match from 50Ω to 25-j15 at 2.4GHz and plot it on a Smith chart."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
smith-charts-mcp
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.
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-jsfor 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
componentsin the exact formatanalyze_circuitandrender_smith_chartaccept. 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-mcpClaude 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 buildThen 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-mcpExpose 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_pathandoutput_pathare disabled, so clients cannot read or write files on your server. Pass Touchstone data astouchstone_contentinstead. SetSMITH_CHARTS_MCP_ALLOW_FS=1only 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 |
| 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. |
| 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. |
| Cascades load → components → source. Returns Z, Γ and VSWR at every node, a frequency sweep, matched bandwidth and tolerance-corner analysis. |
| 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. |
| Pi and T networks for a chosen loaded Q, with every low-pass, high-pass and mixed variant. |
| Single-stub tuner (open or short, shunt or series), with lengths in λ, degrees and metres. |
| λ/4 transformer. Complex loads are first rotated to the nearest voltage maximum or minimum. |
| Summarizes a |
| Rollett K, |Δ|, μ and μ', plus source and load stability circles with their stable side. Can sweep a whole file. |
| Available, operating and unilateral constant-gain circles, with MAG/MSG or G_S,max / G_L,max as reference. |
| Constant noise-figure circles; also evaluates NF and available gain for a proposed source impedance. |
| Simultaneous conjugate match: ΓS, ΓL, GT,max, MSG and U, plus ready-made input and output L-networks. |
| Running version, release notes for any version, and "what changed since X". Also reports runtime capabilities. |
| 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.transformerandcoupled_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 |
| Analyze the load, then design and compare every matching method, verify the best one, and plot it. |
| From an |
| Stability report over frequency, with shaded stability circles. |
| Tune a measured |
| Interactive Smith chart lesson (beginner, intermediate or advanced) with practice problems. |
| Step-by-step homework solution, with every number cross-checked by the tools. |
| 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(preferencedc_block,snap_to_series: "E24"), thenanalyze_circuitwith a sweep, thenrender_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 |
|
| Default summary language ( |
|
| Set to |
|
| HTTP listen settings. |
|
| HTTP requests per minute per client IP ( |
| off | Allow |
| 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-mcpwatermark;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/mcpThe project layout:
src/core: pure math, no MCP dependency.src/render: SVG and PNG chart rendering.src/tools: MCP tool definitions.src/promptsandsrc/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 toolsamplifier_stabilityTwo-port (amplifier) stability analysisARead-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 circuitARead-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 gainARead-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 networksARead-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 QARead-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) transformerARead-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)ARead-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 circlesARead-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 converterARead-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)ARead-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) fileARead-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)AIdempotent
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 impedanceARead-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 & changelogARead-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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
Amateur radio MCP server with band plans, EIRP, cable loss, antenna gains, and more
MCP server for aerospace calculations: orbital mechanics, ephemeris, DSN operations, ...
Remote MCP for JSON repair, hashing, formatting, IDs, dates, units, and other small tools.
QuLab MCP remote server (Streamable HTTP) for computational science and lab tools.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP 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, Mon1,472 npm8MIT
- AlicenseAqualityDmaintenanceA 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.48GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables MCP-compatible agents to generate Qucs circuit schematics, run simulations, and parse results programmatically.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.4AGPL 3.0