Connect AI agents to the Candid MCP server

1. Install the SDK

   Section titled “Install the SDK”
   • Node.js
   • Python

   1
   npm install @scalekit-sdk/node dotenv

   Full SDK reference: Node.js | Python

2. Set your credentials

   Section titled “Set your credentials”

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Section titled “Authorize and make your first call”
   • Node.js
   • Python

   1
   import { ScalekitClient } from '@scalekit-sdk/node'
   2
   import 'dotenv/config'
   3
   import { createInterface } from 'node:readline/promises'
   4
   
   5
   const scalekit = new ScalekitClient(
   6
     process.env.SCALEKIT_ENVIRONMENT_URL,
   7
     process.env.SCALEKIT_CLIENT_ID,
   8
     process.env.SCALEKIT_CLIENT_SECRET,
   9
   )
   10
   const actions = scalekit.actions
   11
   
   12
   const connector = 'candidmcp'
   13
   const identifier = 'user_123'
   14
   
   15
   // Generate an authorization link for the user
   16
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   17
   console.log('Authorize Candid MCP:', link)
   18
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   19
   await rl.question('Press Enter after authorizing...')
   20
   rl.close()
   21
   
   22
   // Make your first call
   23
   const result = await actions.executeTool({
   24
     connector,
   25
     identifier,
   26
     toolName: 'candidmcp_search_organizations',
   27
     toolInput: { query: 'YOUR_QUERY' },
   28
   })
   29
   console.log(result)

   1
   npx tsx quickstart.mts

Connect this agent connector to let your agent:

• Terms taxonomy — Classify text using Candid’s Philanthropy Classification System (PCS) taxonomy to get subject and population codes
• Search organizations — Search Candid’s database for nonprofits and grantmaking organizations by name, mission, location, or type of work
• Resources knowledge — Search Candid’s knowledge base for articles, blog posts, research reports, and training content about the social and philanthropic sector
• Organizations identify mentioned — Resolve nonprofit names mentioned in text to Candid profile URLs
• Locations identify — Detect and resolve geographic names in text to Geonames IDs for use in organization search filters
• Date current — Get today’s date for use in time-sensitive queries and data requests

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.