LinkCensus MCP server

LinkCensus agent clients

Release-candidate source for the LinkCensus REST client/CLI and local stdio MCP gateway. This export contains only the two client packages, their source, tests, notices, license and release metadata. It contains no application server, graph, customer state, deployment configuration or repository history. The public source repository is linkcensus-agent-clients. The hosted MCP endpoint is live at https://linkcensus.com/mcp using Streamable HTTP. Sign in at your account and configure your personal key in a private Authorization: Bearer YOURLINKCENSUSAPI_KEY header. Use a client that supports a custom Authorization header. See the MCP setup guide and API documentation.

Public PyPI package releases remain pending; the local package versions below are separate from hosted availability.

Packages

Free access includes 5 neighborhood lookups per account per UTC calendar month, with up to 5 candidate rows per lookup. REST, CLI and MCP share that counter; rotation does not reset it. Editions and domain resolution do not spend monthly neighborhood attempts but still require authentication and execution admission. Candidates are not independently confirmed competitors; retain edition, provenance, truncation and quota notes. The website ledger and VerifiedPricing budgets are separate. No request triggers a crawl or retries automatically.

The hosted service uses personal bearer keys. The local stdio gateway uses HTTPS REST and remains available as a separate source package. Linux/Python 3.12 is tested for local stdio; other source-supported Python 3.10+/POSIX combinations need acceptance, and Windows is unsupported. See each package's transport limits.

Candidate installation

Public package-index installation is not available from this release candidate. A placeholder wheelhouse path below is not evidence of a public package or downloadable bundle. Use a separately reviewed isolated environment and complete wheelhouse:

python3 -m venv .venv-linkcensus
.venv-linkcensus/bin/python -m pip install --no-index \
  --find-links /path/to/reviewed-wheelhouse \
  linkcensus-client==0.1.0 linkcensus-mcp==0.1.0 mcp==2.3.0
.venv-linkcensus/bin/linkcensus --version
.venv-linkcensus/bin/linkcensus-mcp --version

Provide a key through the private environment or owned regular mode-0600 configuration. Never put it in arguments, public examples or repository files. linkcensus configure saves an already provisioned LINKCENSUSAPIKEY; it does not sign in or issue keys. See client setup and the secret-free launcher template.

Local source checks

No installation or backend is needed for the client package's bounded unit and loopback tests:

cd packages/linkcensus-client
PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=src python3 -m unittest discover -s tests -v

For gateway checks, use a reviewed separate environment with the exact pinned SDK and both distributions installed; add the two source directories to its PYTHONPATH, then run the gateway tests. Tests use synthetic credentials/fixtures, not production. The initial SDK installation and public-index clean-install acceptance are separate operations, not test side effects.

Distribution and security

Shortened. The full README is on GitHub.