General

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: \