MCP Agents

Getting Started with BrightForest MCP

Copy page

Getting Started

This guide will help you connect your AI client to BrightForest's MCP servers and start using domain-specific agent capabilities.

Prerequisites

• An MCP-compatible AI client (Claude Desktop, Continue.dev, or custom MCP client)
• A BrightForest account with API access
• Node.js 18+ (if using the Node.js MCP SDK)

Connection Methods

Option 1: Claude Desktop

Claude Desktop has built-in MCP support. Add BrightForest agents to your claude_desktop_config.json:

Code
 
{
  "mcpServers": {
    "brightforest-platform": {
      "command": "node",
      "args": ["/path/to/brightforest-mcp-server/dist/index.js"],
      "env": {
        "BRIGHTFOREST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 2: Direct Connection

Connect directly to a BrightForest MCP server endpoint:

Code
 
# Connect via stdio transport
npx @brightforest/mcp-client \
  --server brightforest-platform \
  --api-key your-api-key-here

Option 3: Custom Integration

Use the MCP SDK to integrate BrightForest agents into your own application:

Code
 
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "node",
  args: ["/path/to/brightforest-mcp-server/dist/index.js"],
  env: {
    BRIGHTFOREST_API_KEY: process.env.BRIGHTFOREST_API_KEY,
  },
});

const client = new Client(
  {
    name: "my-app",
    version: "1.0.0",
  },
  {
    capabilities: {},
  },
);

await client.connect(transport);

// List available tools
const tools = await client.listTools();
console.log("Available tools:", tools);

Authentication

All BrightForest MCP servers require authentication via API key. You can generate API keys from your BrightForest Dashboard.

Available MCP Servers

BrightForest provides MCP servers for each domain. Choose the ones relevant to your workflow:

Domain	Server Name	Connection URL
Platform Integration	brightforest-platform	mcp://platform.brightforest.io
Enterprise Config	brightforestx-enterprise	mcp://enterprise.brightforestx.com
AI Orchestration	brightpath-orchestration	mcp://orchestration.brightpath.ai
Algorithm Optimization	pathx-optimization	mcp://optimization.pathx.ai
Design-to-Code	figmatofullstack-design	mcp://design.figmatofullstack.com
AI Design Assistant	figmatofullstack-ai	mcp://ai.figmatofullstack.ai
ML Platform	mlninjas-platform	mcp://platform.mlninjas.com
Portfolio Management	clifforddalsoniii-portfolio	mcp://portfolio.clifforddalsoniii.com
DIY AI Builder	getdiyai-builder	mcp://builder.getdiyai.com
RPA Workflows	getdiyrpa-workflows	mcp://workflows.getdiyrpa.com
App Builder	appnowhq-builder	mcp://builder.appnowhq.com
MLOps	brightforest-mlops	mcp://mlops.brightforest.ai
AI Learning	iheartai-learning	mcp://learning.iheartai.ai

Testing Your Connection

Once configured, test your connection by querying available capabilities:

Code
 
# List available tools
mcp-client list-tools --server brightforest-platform

# List available resources
mcp-client list-resources --server brightforest-platform

# List available prompts
mcp-client list-prompts --server brightforest-platform

Next Steps

Troubleshooting

Connection Issues

• Verify your API key is valid and has the correct permissions
• Check that the MCP server path is correct
• Ensure Node.js version is 18 or higher
• Review logs in your MCP client's debug output

Permission Errors

• Confirm your API key has access to the requested agent domain
• Check your BrightForest plan includes the agent you're trying to use
• Contact support if you believe you should have access

Support

Need help? Reach out to us:

• Discord Community
• GitHub Discussions
• Support Email