Mimiq MCP

Test a page, a piece of copy or a sign-up flow on simulated people before launch. Mimiq returns their reactions, objections and steps so you can investigate confusing language and places where they get stuck.

Connect to Mimiq

The hosted endpoint works with MCP clients that support Streamable HTTP:

https://mcp.mimiqai.com/mcp

1. Create a free account.
2. Open Settings, find Use Mimiq from your coding agent, then Create a key. Save the key when it is shown.
3. Add the endpoint to your client's remote MCP settings. Set the HTTP header Authorization to Bearer YOUR_MIMIQ_API_KEY using its secret store. The key starts with mq_sk_; keep it out of shared files.
4. Refresh the tool list and ask it to test your content for a specific audience.

Example for clients that accept this JSON shape:

{
  "mcpServers": {
    "mimiq": {
      "type": "http",
      "url": "https://mcp.mimiqai.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MIMIQ_API_KEY" }
    }
  }
}

Use your client's secret mechanism for the placeholder. Configuration field names vary by client; the endpoint and bearer header stay the same. The hosted connection does not require installing this npm package.

Try these tasks

• "Test my landing page on independent designers buying their first invoicing tool. Find unclear promises and unanswered questions."
• "Have one simulated person try to sign up on my staging site. Stop before any purchase. Show the last completed step and what blocked them."
• "Compare these two headlines on small business owners. Show objections to each and state that this is simulated feedback."

Pages need a publicly reachable URL. A local development server needs an explicitly opened tunnel or a preview deployment. A page is reachable by others while a public tunnel runs.

Tools in this npm runtime

| Tool | Purpose | | --- | --- | | mimiq.test_page | Inspect a page with simulated people and return reactions. | | mimiq.test_flow | Try a multi-step task in a real browser with simulated people. | | mimiq.test_copy | Test copy; optional variant_b returns two sets of simulated reactions. | | mimiq.test_text | Review positioning, instructions or error messages. | | mimiq.test_component | Review a component from HTML or a description. | | mimiq.ask_audience | Ask simulated people a multiple-choice question. |

This package is the six-tool local HTTP adapter. The hosted service also provides mimiq.compare_copy and mimiq.compare_urls; consult its live tool list and documentation. Updating this package does not change the hosted service.

Results and limits

Results contain each simulated person's action, reaction, objections and what would help. Page and flow runs can include journey steps. The local adapter returns aggregate counts and per-person results. Use the reasons to form hypotheses, then check consequential decisions with real people or measured behavior.

Everyone in a Mimiq test is simulated. A result is not a survey of recruited people, a prediction of conversion lift or proof of demand. Research on historical headline tests is available in the public register; it does not establish that a new page or flow will perform the same way.

Credits and pricing

• A free account includes 50 credits.
• Credit packs start at $9.
• Monthly plans are available.
• A standard reaction uses one credit per simulated person per run. A flow uses several credits per simulated person; Usage shows the current number. Testing two copy variants uses two runs.

See Pricing and Usage for the offer, balance and cost of your test. Credit grants and billing are managed by Mimiq's backend, not by installing this package.

Run the local HTTP adapter

Node.js 18 or newer is required. For a backend you already operate locally:

MIMIQ_API_URL=http://127.0.0.1:8000/api npx @mimiqai/[email protected]

Point your MCP client at http://127.0.0.1:8787/mcp. This starts an HTTP server; it is not a stdio MCP command. A working Mimiq backend is required to run tests. For ordinary use, connect directly to the hosted endpoint.

| Environment variable | Default | Purpose | | --- | --- | --- | | MIMIQ_API_URL | http://127.0.0.1:8000/api | Backend API base URL. | | MIMIQ_API_KEY | Unset | Backend key, if required locally. | | HOST | 127.0.0.1 | Listening interface. | | PORT | 8787 | Local HTTP port. | | MIMIQ_MCP_PATH | /mcp | MCP HTTP route. |

The adapter forwards the client's bearer key to the backend as X-API-Key.

Troubleshooting

| Problem | Next step | | --- | --- | | Not enough credits | Check Usage, reduce the count, or choose a pack or monthly plan. | | Key rejected | Copy a current key in Settings and check the bearer header. | | Page unreachable | Check that the exact URL opens outside your local network. | | Test timed out | Check its state before retrying; the backend may still be working. | | No hosted comparison tools in the local adapter | Connect to the hosted endpoint for its current tool set. |

License

MIT. The adapter is open source; simulations run on a separate backend.