Candid MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

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

   .env

   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

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'candidmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Candid MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'candidmcp_search_organizations',
     toolInput: { query: 'YOUR_QUERY' },
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "candidmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Candid MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"query":"YOUR_QUERY"},
       tool_name="candidmcp_search_organizations",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

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

Tool list

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.

candidmcp_current_date#Get today's date for use in time-sensitive queries and data requests.0 params▾

Get today's date for use in time-sensitive queries and data requests.

candidmcp_identify_locations#Detect and resolve geographic names in text to Geonames IDs for use in organization search filters.1 param▾

Detect and resolve geographic names in text to Geonames IDs for use in organization search filters.

NameTypeRequiredDescription

textstringrequiredNo description.

candidmcp_identify_mentioned_organizations#Resolve nonprofit names mentioned in text to Candid profile URLs.1 param▾

Resolve nonprofit names mentioned in text to Candid profile URLs.

NameTypeRequiredDescription

organizationsarrayrequiredNo description.

candidmcp_knowledge_resources#Search Candid's knowledge base for articles, blog posts, research reports, and training content about the social and philanthropic sector.3 params▾

Search Candid's knowledge base for articles, blog posts, research reports, and training content about the social and philanthropic sector.

NameTypeRequiredDescription

querystringrequiredNo description.

sourcesarrayrequiredNo description.

news_days_agointegeroptionalNo description.

candidmcp_search_organizations#Search Candid's database for nonprofits and grantmaking organizations by name, mission, location, or type of work.9 params▾

Search Candid's database for nonprofits and grantmaking organizations by name, mission, location, or type of work.

NameTypeRequiredDescription

querystringrequiredNo description.

geonameids_of_geographies_servedstringoptionalNo description.

geonameids_of_organization_locationstringoptionalNo description.

leader_demographicsstringoptionalNo description.

located_admin1stringoptionalNo description.

located_postal_codestringoptionalNo description.

org_seal_statusstringoptionalNo description.

populations_served_codesstringoptionalNo description.

subject_codesstringoptionalNo description.

candidmcp_taxonomy_terms#Classify text using Candid's Philanthropy Classification System (PCS) taxonomy to get subject and population codes.1 param▾

Classify text using Candid's Philanthropy Classification System (PCS) taxonomy to get subject and population codes.

NameTypeRequiredDescription

textstringrequiredNo description.