Blacksmith Master Guide
Chat now

Blacksmith Master Guide API

Use this chatbot from your own code, website or mobile app: a simple request/response API, OpenAPI and Postman documents, and Connect so your users can sign in with this chatbot.

Documentation

Import the OpenAPI document or the Postman collection to try every endpoint.

Example request

curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/chat \
  -H "Authorization: Bearer c6k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello!"}],"lang":"en"}'

Requests follow this chatbot’s plans, free daily requests and balance, just like the chat.

Public endpoints

No key needed: the chatbot profile and its published blog posts.

curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master?lang=en
curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/posts
curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/posts/<id>

MCP server

Connect this address in any MCP client. Without a key it reads public information, and with a key it can chat.

Use Blacksmith Master Guide inside ChatGPT, Claude, Cursor or VS Code. With your key the AI can chat with Blacksmith Master Guide; the owner key can also manage blog posts.

Server address

Clients that can send headers use this address with the header Authorization: Bearer <key>.

Address with key

For apps that cannot send headers (ChatGPT, Claude.ai). The key is inside the address: keep it secret like a password.

Set up step by step

Pick your app and follow the steps. It takes about a minute.

Claude (claude.ai and Claude Desktop)
  1. Open Claude and go to Settings, then Connectors.
  2. Click Add custom connector.
  3. Enter blacksmith-master as the name and paste the address with key below as the server URL. Leave the OAuth fields empty.
  4. Click Add, then Connect if Claude asks.
  5. In a new chat, open the tools menu (the sliders icon) and turn blacksmith-master on.
  6. Ask something, for example: show my chatbots and their status.
Claude Code
  1. Run this command in your terminal:
    claude mcp add --transport http blacksmith-master https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp \
      --header "Authorization: Bearer your_key"
  2. Start Claude Code and type /mcp to check that blacksmith-master is connected.
  3. Ask in plain words; Claude Code calls the blacksmith-master tools when needed.
ChatGPT
  1. Open ChatGPT on the web and go to Settings, then Apps and Connectors, then Advanced settings, and turn on Developer mode.
  2. Go back to Apps and Connectors and click Create.
  3. Enter blacksmith-master as the name and paste the address with key below as the MCP server URL.
  4. Choose No authentication, confirm that you trust this app and click Create.
  5. In a new chat, click the plus button, choose Developer mode and select blacksmith-master.
  6. Ask something; ChatGPT asks for your approval before actions that change data.
Cursor
  1. Open Cursor Settings, then MCP, then Add new MCP server. You can also edit ~/.cursor/mcp.json directly.
  2. Paste this configuration and save:
    {
      "mcpServers": {
        "blacksmith-master": {
          "url": "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp",
          "headers": {
            "Authorization": "Bearer your_key"
          }
        }
      }
    }
  3. Check that blacksmith-master shows a green dot, then use it in Agent mode.
VS Code (GitHub Copilot)
  1. Create the file .vscode/mcp.json in your project, or run the command MCP: Add Server.
  2. Paste this configuration and save:
    {
      "servers": {
        "blacksmith-master": {
          "type": "http",
          "url": "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp",
          "headers": {
            "Authorization": "Bearer your_key"
          }
        }
      }
    }
  3. Click Start above the server, open Copilot Chat in Agent mode and enable the blacksmith-master tools.
Windsurf, Gemini CLI and other clients
  1. Any client that supports remote MCP over Streamable HTTP works: use the server address and the header Authorization: Bearer <key>.
  2. If your client only runs local (stdio) servers, such as older Claude Desktop versions, add this configuration. It uses mcp-remote and needs Node.js:
    {
      "mcpServers": {
        "blacksmith-master": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp?key=your_key"
          ]
        }
      }
    }
  3. Restart the client and look for the blacksmith-master tools.

Connect: sign in with this chatbot

Let users of your website or mobile app sign in with this chatbot and chat through your app. Uses OAuth 2.0 with PKCE.

Send the user to the consent page

/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256

Exchange the returned code for a key

curl https://blacksmith-master.chatbot6.com/api/v1/connect/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"authorization_code","code":"<code>","client_id":"<client_id>","redirect_uri":"<redirect_uri>","code_verifier":"<code_verifier>"}'

Call the chat API with that key on the user’s behalf

Your key

Sign in to see your key. A key is created automatically for every account.

Sign in

Sign in to create API keys and register Connect apps.

Sign in