BirdSafeDocumentation
Back to site
Browse docs
Documentation homeInstall and first backupBrowse, search, and organizeBackup, export, and restoreNotion syncMCP integrationAccount and billingTroubleshootingChangelogPrivacy policyTerms of serviceSecurity overview

Advanced connection

Use your library through MCP

Connect BirdSafe search to an MCP-compatible AI client without placing account passwords in configuration files.

Before you begin

  • A signed-in BirdSafe account with access to the feature
  • Node.js 18 or later
  • An MCP Key generated in BirdSafe Settings—not a Twitter/X password or payment key

Connect the service

Run the connection command in a terminal. Replace the example with your own MCP Key.

npx birdsafe-mcp-service@latest connect --key mcp_sk_xxx

Configure a client

An MCP-compatible client starts the BirdSafe service and points it at the production API. Prefer the client's secure environment-variable or secret store.

BIRDSAFE_MCP_KEY=mcp_sk_xxx
BIRDSAFE_API_BASE=https://api.birdsafe.nan0.in
birdsafe-mcp-service

Verify and revoke

  • Ask for a save you can independently confirm
  • Regenerate or inspect the MCP Key after a 401
  • Immediately revoke and rotate a leaked key
  • Never commit a real key to Git

Data boundaries

MCP exposes only the search and actions BirdSafe currently supports. Conversation history and logs created by the AI client are governed by that client's privacy policy. Review its retention settings before connecting.