first100-mcp 2.1.0

package/README.md

@@ -0,0 +1,35 @@
+# first100-mcp
+
+Gives any MCP client the First100 go-to-market tools: publish and schedule posts on X, LinkedIn, Threads and Bluesky, find communities and local businesses, run on-page SEO checks, and send cold email through your own SMTP.
+
+Get an API key at https://firsthundred.app/dashboard/keys.
+
+## Clients that speak HTTP (no install needed)
+
+```bash
+# Claude Code
+claude mcp add --transport http first100 https://firsthundred.app/api/mcp \
+  --header "Authorization: Bearer f100_..."
+```
+
+## Clients that need stdio
+
+```json
+{
+  "mcpServers": {
+    "first100": {
+      "command": "npx",
+      "args": ["-y", "first100-mcp"],
+      "env": { "FIRST100_API_KEY": "f100_..." }
+    }
+  }
+}
+```
+
+Works in Codex, Cursor, Windsurf, Zed, Claude Desktop and anything else that launches stdio servers.
+
+## Tools
+
+See [what your agent can do](https://firsthundred.app/docs/tools) for a capability overview. Start with the [quickstart](https://firsthundred.app/docs/quickstart) or [client setup guide](https://firsthundred.app/docs/clients). Once connected, your MCP client discovers the available tools and their instructions directly from First100.
+
+For agents: start at [llms.txt](https://firsthundred.app/llms.txt), read the [Markdown guide](https://firsthundred.app/docs/agents.md), or load the [First100 JSON guide](https://firsthundred.app/agents.json). These describe setup and use; authenticated MCP tool discovery provides the current tool inputs.

package/bin.mjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+// stdio bridge to the hosted First100 MCP server, for clients that cannot speak Streamable HTTP directly.
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const key = process.env.FIRST100_API_KEY;
+if (!key) {
+  console.error("FIRST100_API_KEY is not set. Create a key at https://firsthundred.app/dashboard/keys and export it.");
+  process.exit(1);
+}
+
+const url = process.env.FIRST100_MCP_URL ?? "https://firsthundred.app/api/mcp";
+const require = createRequire(import.meta.url);
+const remotePackage = require.resolve("mcp-remote/package.json");
+const proxy = join(dirname(remotePackage), require("mcp-remote/package.json").bin["mcp-remote"]);
+
+const child = spawn(process.execPath, [proxy, url, "--header", `Authorization: Bearer ${key}`], { stdio: "inherit" });
+child.on("exit", (code) => process.exit(code ?? 0));

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "first100-mcp",
+  "version": "2.1.0",
+  "description": "First100 MCP server for AI agents: publish and schedule social posts, find customers, run SEO checks, send outreach.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "first100-mcp": "bin.mjs"
+  },
+  "files": [
+    "bin.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "social-media",
+    "go-to-market",
+    "claude",
+    "codex",
+    "cursor"
+  ],
+  "homepage": "https://firsthundred.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jpalepu/first100"
+  },
+  "dependencies": {
+    "mcp-remote": "^0.1.49"
+  },
+  "mcpName": "io.github.jpalepu/first100"
+}