# Connect an MCP client to the public preview.

> See the endpoint, transport, tool, resource, anonymous scan limits and the one recorded connect procedure for the PrompterJack MCP public preview.

Canonical page: https://prompterjack.com/products/mcp-connector

## Endpoint and transport

Point an MCP client at `https://prompterjack.com/api/mcp` over Streamable HTTP — the only transport and only endpoint this preview serves.

## Auth mode: none (public preview)

The endpoint accepts anonymous Streamable HTTP POST requests. Cookies and `Authorization` headers do not grant access and are stripped before the request reaches the MCP handler. Anonymous per-IP and global daily scan limits apply, so clients behind a shared egress IP share one allowance. There is no user, tenant or account identity in this endpoint. Authenticated, account-scoped access is in development; this page will describe it when the deployed endpoint publishes its OAuth metadata.

## One tool, one resource

The server registers exactly one tool, `preview_public_repository`, and one resource, `prompterjack://contracts/public-preview/v1`, describing the contract's scope, limits and unsupported capabilities. This build reports server version 0.1.0 and contract version 1 today.

## What the anonymous allowance is

By default 20 uncached scans per caller IP and 5,000 uncached scans globally per UTC day. Cache hits do not consume allowance and cache entries last seven days. Requests are capped at 16 KiB while the body is read. These are anonymous limits with no user, tenant or account identity behind them, so every client behind a shared egress IP shares one allowance.

## Add it to your client

These are the steps of the run recorded on 2026-09-14, which used `@modelcontextprotocol/client` 2.0.0 (declared in apps/api-v2/package.json). That run targeted local `wrangler dev` at `:8798`; no run against the deployed URL is recorded, so treat the endpoint below as where to point a client, not as an observed result.

```text
1. Install the client the recorded run used:
   npm install @modelcontextprotocol/client@2.0.0

2. Open a Streamable HTTP transport on the endpoint:
   import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client'
   const client = new Client({ name: 'my-client', version: '1.0.0' })
   const transport = new StreamableHTTPClientTransport(new URL('https://prompterjack.com/api/mcp'))

3. Connect, list the tool, call it:
   await client.connect(transport)
   const { tools } = await client.listTools()
   const result = await client.callTool({ name: 'preview_public_repository', arguments: { repoUrl: 'octocat/Hello-World' } })
```

## Recorded client runs

Three clients were run against this endpoint on 2026-09-14, all against local `wrangler dev` at `:8798` — see the compatibility matrix for the full record and its update cadence. `@modelcontextprotocol/client` 2.0.0 (declared in apps/api-v2/package.json) and MCP inspector CLI 1.0.2 both completed initialize, tools/list and a tools/call of `preview_public_repository`. Claude Code 2.1.259 registered the server and listed the tool; tool-call completion was not recorded. No row was taken against a deployed URL, and no client's own --version output was captured at run time.

## Custom connector, not a directory listing

Connecting a client to this endpoint the way described above is a custom, self-configured connector — not an installation from a vendor's app directory. PrompterJack is not listed in any vendor's connector directory, and no such listing has been applied for or approved.

## Does this endpoint require authentication?

Not yet. It answers anonymous Streamable HTTP requests under the anonymous scan limits above. See docs/MCP.md for when authenticated, account-scoped access ships.

## Can this tool read a private repository?

No. `preview_public_repository` only accepts a public GitHub owner/repo or HTTPS URL, and the response never includes source file contents.

## References

- [Official MCP TypeScript SDK: Streamable HTTP handler](https://github.com/modelcontextprotocol/typescript-sdk/blob/main/docs/serving/http.md)
- [MCP Streamable HTTP specification](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports)

## Next step

[Read the MCP docs](https://prompterjack.com/docs)