Barndoor SDK Examples

This directory contains working examples that demonstrate how to use the Barndoor TypeScript SDK with MCP servers.

Key Patterns

Both examples follow the same proven pattern:

// 1. Authenticate
const sdk = await loginInteractive();

// 2. Ensure server is connected
await ensureServerConnected(sdk, SERVER_SLUG);

// 3. Create MCP client
const mcpClient = await makeMcpClient(sdk, SERVER_SLUG);

// 4. Use MCP client
const { tools } = await mcpClient.listTools();
const result = await mcpClient.callTool({ name: 'tool_name', arguments: {} });

// 5. Cleanup
await mcpClient.close();
await sdk.close();

Configuration

Both examples use the same authentication pattern:

1. Environment Variables (create a .env file):

   AUTH_DOMAIN=your-auth-domain
   AGENT_CLIENT_ID=your-client-id
   AGENT_CLIENT_SECRET=your-client-secret
   MODE=development  # or production
   

2. Server Configuration: Change the SERVER_SLUG constant in each file to target different MCP servers:

   • 'salesforce' - Salesforce integration
   • 'notion' - Notion integration
   • Or any other configured MCP server

Working Examples

1. basic-mcp-client.js - Direct MCP Client

Basic example showing direct MCP server interaction without AI frameworks. What it does:

• Authenticates with Barndoor
• Connects to an MCP server
• Lists available tools and resources
• Executes basic operations

Requirements:

npm install dotenv

Run:

node examples/basic-mcp-client.js

/**
 * 🔗 Universal Barndoor MCP Client
 *
 * Lets the user pick any available MCP server, list its tools,
 * and run a custom prompt / command interactively — no hardcoded Salesforce or Notion.
 */

import 'dotenv/config';
import readline from 'readline/promises';
import {
  loginInteractive,
  ensureServerConnected,
  makeMcpClient,
  BarndoorSDK,
  getDynamicConfig,
  getStaticConfig,
  hasOrganizationInfo,
} from '../dist/index.esm.js';

// simple input helper
const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
async function ask(q) {
  return (await rl.question(q)).trim();
}

async function main() {
  try {
    console.log('\n🚀 Starting Universal MCP Client Example...\n');

// ---------------------------------------------------------------------
    // 1. Authenticate to Barndoor
    // ---------------------------------------------------------------------
    console.log('🔐 Authenticating with Barndoor...');
    let sdk;
    const envToken = process.env.BARNDOOR_ACCESS_TOKEN;

if (envToken) {
      console.log('🔑 Using token from BARNDOOR_ACCESS_TOKEN');
      const cfg = hasOrganizationInfo(envToken)
        ? getDynamicConfig(envToken)
        : getStaticConfig();
      sdk = new BarndoorSDK(cfg.apiBaseUrl, { token: envToken });
      await sdk.listServers();
      console.log('✅ Authentication successful (env token)!');
    } else {
      sdk = await loginInteractive();
      await sdk.listServers();
      console.log('✅ Authentication successful!');
    }

// ---------------------------------------------------------------------
    // 2. List all available servers
    // ---------------------------------------------------------------------
    const servers = await sdk.listServers();
    if (!servers.length) throw new Error('No MCP servers found for this user.');
    console.log('\n📡 Available MCP servers:');
    servers.forEach((s, i) => console.log(`  ${i + 1}. ${s.slug} (${s.connection_status})`));

// Ask user which one to use
    let idx = await ask('\n👉 Enter the number of the server you want to use: ');
    const choice = servers[parseInt(idx) - 1];
    if (!choice) throw new Error('Invalid selection.');
    const SERVER_SLUG = choice.slug;
    console.log(`\n🔗 Selected: ${SERVER_SLUG}\n`);

// ---------------------------------------------------------------------
    // 3. Ensure it’s connected
    // ---------------------------------------------------------------------
    await ensureServerConnected(sdk, SERVER_SLUG);
    console.log(`✅ ${SERVER_SLUG} connected.`);

// ---------------------------------------------------------------------
    // 4. Build MCP client and show available tools
    // ---------------------------------------------------------------------
    const mcpClient = await makeMcpClient(sdk, SERVER_SLUG);
    console.log('\n🔧 Fetching available tools...');
    const { tools = [] } = await mcpClient.listTools();
    if (!tools.length) console.log('⚠️  No tools found for this server.');
    else tools.forEach((t, i) => console.log(`  ${i + 1}. ${t.name} — ${t.description || 'No description'}`));

// ---------------------------------------------------------------------
    // 5. Ask user for a custom prompt
    // ---------------------------------------------------------------------
    const prompt = await ask('\n💬 What do you want to ask or do? (describe task): ');
    console.log(`\n🧠 Interpreting prompt: \