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.

Name Type Required Description

text string required No 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.

Name Type Required Description

organizations array required No 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.

Name Type Required Description

query string required No description.

sources array required No description.

news_days_ago integer optional No 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.

Name Type Required Description

query string required No description.

geonameids_of_geographies_served string optional No description.

geonameids_of_organization_location string optional No description.

leader_demographics string optional No description.

located_admin1 string optional No description.

located_postal_code string optional No description.

org_seal_status string optional No description.

populations_served_codes string optional No description.

subject_codes string optional No 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.

Name Type Required Description

text string required No description.