GlockApps MCP server
Commit Oct 26, 2026Run inbox placement tests across Gmail, Outlook, Yahoo, and 30+ providers to diagnose spam issues and improve email deliverability.
Also known as glocksoftware/glockapps-mcp, glockapps-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 26, 2026
- License
- MIT
What is GlockApps MCP?
GlockApps runs inbox placement tests across Gmail, Outlook, Yahoo, and 30+ providers to diagnose spam issues and improve email deliverability.
Summary generated from the project's README
About GlockApps MCP server
Diagnosing email deliverability issues and checking inbox placement across Gmail, Outlook, Yahoo, and over 30 other providers is what this server enables. Developers and email marketers use it to identify why campaigns land in spam and to receive prioritized advice on what to fix. The server is hosted by GlockApps, so there is no local installation required, though a GlockApps account with API access and test credits is necessary to run tests.
Users connect via OAuth through clients like Claude Desktop, Claude Code, or ChatGPT, or by providing an API key directly to clients like Cursor, Windsurf, or Continue. The workflow involves using create_test to receive seed addresses, sending a campaign from an external platform using a specific marker, and then using tools like get_results or diagnose to analyze the outcome. The server provides fifteen tools, including list_projects, get_test_status, and compare_tests, to manage the testing lifecycle and evaluate performance against previous campaigns.
What you can do with it
- 1Identify spam triggersAsk the assistant to explain why a specific email campaign ended up in the spam folder.
- 2Monitor inbox placement ratesCheck if a recent test has completed and what percentage of emails reached the inbox.
- 3Validate deliverability improvementsCompare the results of a new test against a previous one to see if recent changes worked.
- 4Prioritize technical fixesDetermine which email providers are filtering messages and which issues should be addressed first.
Written from the project's README. Every use case is checked against a quote from it.
How to install GlockApps MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall GlockApps MCP in Claude Code
$ claude mcp add --transport http glockapps-mcp https://api.glockapps.com/mcpInstall GlockApps MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"glockapps-mcp": {
"url": "https://api.glockapps.com/mcp"
}
}
}Install GlockApps MCP in VS Code
.vscode/mcp.json
{
"servers": {
"glockapps-mcp": {
"type": "http",
"url": "https://api.glockapps.com/mcp"
}
}
}Install GlockApps MCP in VS Code CLI
$ code --add-mcp '{"name":"glockapps-mcp","type":"http","url":"https://api.glockapps.com/mcp"}'Install GlockApps MCP in Codex
$ codex mcp add glockapps-mcp --url https://api.glockapps.com/mcpInstall GlockApps MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.glockapps-mcp] url = "https://api.glockapps.com/mcp"
Install GlockApps MCP in Gemini CLI
$ gemini mcp add -s user --transport http glockapps-mcp https://api.glockapps.com/mcpInstall GlockApps MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"glockapps-mcp": {
"url": "https://api.glockapps.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableglocksoftware/glockapps-mcp is public and reachablegithub.com/glocksoftware/glockapps-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-26github.com/glocksoftware/glockapps-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubGlockApps MCP
Run real inbox placement tests from your AI assistant. Ask it to start a test, and it hands you the seed addresses to send to; ask again once you have sent, and it tells you who put you in the inbox, who put you in spam, and what to fix first.
The seed network is live mailboxes at Gmail, Outlook, Yahoo, AOL, Zoho, corporate Exchange and 30+ other providers.
https://api.glockapps.com/mcp
This repository is documentation and the registry manifest. The server itself is hosted by GlockApps — there is nothing here to install or run.
What you need
- A GlockApps account with API access on the plan. Your API key is on Account → API / MCP.
- Test credits. Every test costs one, whether it is started here or in the GlockApps web app.
Quick connect
Claude.ai, Claude Desktop
Settings → Connectors → Add custom connector. Paste the address above and leave Client ID and Client Secret empty. Select Connect: a GlockApps page opens and asks for your API key once.
Claude Code
claude mcp add --transport http glockapps https://api.glockapps.com/mcp
Then /mcp in the session, and authenticate in the browser window it opens.
ChatGPT
Turn on developer mode (Settings → Security and login), then Plugins → + → Create app → Create MCP App. Paste the address, leave Authentication on OAuth, select Create, and paste your API key on the GlockApps page that opens. Developer mode is required while the connector is not yet in the ChatGPT directory.
Cursor, Windsurf, Continue and other clients
Clients that cannot do OAuth can send the API key directly. Copy a config from
configs/ and put your key in it:
{
"mcpServers": {
"glockapps": {
"url": "https://api.glockapps.com/mcp",
"headers": { "Authorization": "Bearer YOUR_GLOCKAPPS_API_KEY" }
}
}
}
Full per-client instructions: docs/connect.md.
How a test works
The one thing to understand before you start: this connector cannot send your email. It gives you addresses to send to, and it reads what arrives.
list_projects— resolves the project everything else needs.create_test— costs 1 credit. Returns the seed addresses and a marker.- You send. Send the campaign you want to test, from the platform you are testing, to every
seed address, with the marker included — either the
X-API-Campaign-idheader or theid: ...line in the body. wait_for_test— results are usually usable about 10 minutes after sending.get_results, thendiagnosefor what to fix, worst first.
A send without the marker never matches the test. Nothing arrives, the test never finishes, and the credit is still spent. If that happens, ask your assistant to delete the test: the credit comes back while no result has arrived.
Some providers accept mail slowly, so a test that has not "finished" after an hour is normal, not broken.
Things to ask it
- "Start an inbox placement test on my main project."
- "Has the test finished? What is the inbox rate?"
- "Why did this campaign land in spam?"
- "Compare this test with yesterday's. Did the fix work?"
- "Which providers are filtering us, and what should I change first?"
Tools
Fifteen tools, thirteen of them read-only. Full reference with parameters:
docs/tools.md.
| Read | list_projects list_folders list_providers list_tests get_balance get_seed_list get_test_status wait_for_test get_results diagnose get_content_analysis compare_tests get_shared_link |
| Write | create_test — costs 1 credit |
| Destructive | delete_test — removes the test and its results; refunds the credit only while no result has arrived |
Security
- Scopes.
inbox_placement:readandinbox_placement:write. The connector cannot see or change your password, billing details or sending accounts. - It never sends email. Your campaign is sent by you, from your own platform.
- Your key is not shared with the AI provider. In the OAuth flow it is exchanged on a GlockApps page for a token scoped to this connector; it stays on your GlockApps account.
- Regenerating your key does not break an OAuth connection. The connector records which account it is linked to, not the key, and picks up the current one on each call. It does end any connection using the static-key method above.
- Rate limits. Test creation is capped per hour and per day on top of your credit balance.
get_balancereports the effective number.
Troubleshooting
"No test credits left" — top up in GlockApps, or run the test from the web app. get_balance
tells you what is left before you start.
The test never finishes and shows nothing — almost always a send without the marker. Delete the test to get the credit back, start a fresh one, and follow its sending instructions exactly.
Some results missing after an hour — usually fine; slower providers take hours. Nothing at all within ten minutes of sending means the marker was missing.
"Shareable report links are unavailable" — not part of every subscription. Your assistant can still read per-mailbox results directly.
Connecting fails with "API key not recognised" — copy it again from Account → API / MCP; API access has to be enabled on your plan.
Support
Open an issue or email support@glock-apps.com.
- Setup guide: https://glockapps.com/mcp-setup/
- About the connector: https://glockapps.com/mcp/
- Privacy policy: https://glockapps.com/privacy-policies/
GlockApps MCP questions
How do I add GlockApps MCP to Claude Code?
Run claude mcp add --transport http glockapps-mcp https://api.glockapps.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add GlockApps MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this tool send emails for me?
No, the connector does not send your email. It provides seed addresses for you to send your campaign to from your own platform.
How much does a test cost?
Every test costs one credit, whether it is started through the MCP server or the GlockApps web app.
What should I do if a test never finishes?
This is usually caused by a send without the required marker. You should delete the test to receive a credit refund and then start a fresh one.
How long does it take to see results?
Results are typically usable about 10 minutes after sending, though some providers may take longer.