Reference

simplelogin-mcp is a self-hostable, MIT-licensed open source project. It provides an MCP server for the SimpleLogin API that runs through Local stdio, Direct Node.js — Streamable HTTP, or Docker Compose — Streamable HTTP.

Pre-1.0, with a carefully managed tool surface

Tool names, response bounds, MCP annotations, and safety behavior are treated as public contracts. Changes to that surface should be documented and tested together.

Technical reference

ConfigurationReview every environment setting, default, and deployment boundary.

Tool catalogBrowse every registered tool, input schema, annotation, and result bound.

API coverageSee which SimpleLogin API areas are supported, deferred, or intentionally excluded.

Repository policies

ContributingSet up a checkout, follow the catalog-backed tool pattern, and run the project checks.

Reporting issues and supportChoose the right support channel and prepare a safe, reproducible report.

Security policySee supported versions and report vulnerabilities through the private channel.

Documentation contracts

• The tool catalog is generated from the same catalog and schemas used by the server.
• API coverage records supported, deferred, and intentionally excluded SimpleLogin API areas.
• Client compatibility records current client evidence, unavailable routes, and generic transport requirements.

The server catalog is the source of truth for registered tool order, behavior annotations, bounds, and generated reference content. API coverage is tracked separately so the documentation does not imply that every SimpleLogin API endpoint is exposed.

Normal tests run without live SimpleLogin credentials. The live smoke test is an explicit, opt-in workflow and is not required for ordinary first-run verification.

Documentation and support

• Published container package provides the GHCR image used by the operator Compose file.
• llms.txt provides a machine-readable index of this documentation.
• Troubleshooting covers startup, transport, Docker, and upstream API failures.
• Operations covers inspection, exact-version upgrades, rollback, credential rotation, and shutdown.
• FAQ explains project scope, privacy, plan limitations, and when to use SimpleLogin directly.
• Reporting issues and support explains what to include in a public issue and what must instead be reported privately.

License

The project is available under the MIT License. The source repository also contains the changelog, support policy, contribution guide, security policy, and release documentation.

Open source and independently maintained

Browse the source, report an issue, or follow the project on GitHub.

Star on GitHubMIT licensedSelf-hostableNode 24