# Brief 3: Publishing Your Graph to the Fodda Network

> **For:** Strategists who've built a Pattern Graph and want to make it queryable via AI
> **Purpose:** Register your Google Sheet (or your own MCP server) on Fodda so it's discoverable by Claude, Gemini, Cursor, and every MCP-compatible tool
> **Date:** 2026-03-22

---

## What You're Doing

You've built a Pattern Graph in Google Sheets (Brief 1) and populated it with signals and patterns (Brief 2). Now you're making it available to AI systems.

When you register on Fodda, your graph joins a network of expert-curated knowledge graphs. Anyone using Fodda's MCP connection can query your graph alongside others — your expertise becomes a live data source for AI.

**Your data stays in your Google Sheet. Fodda only reads it.**

---

## Two Registration Paths

| Path | Who It's For | Difficulty |
|------|-------------|-----------|
| **Path 1: Google Sheets Graph** | Most strategists — you have a Sheet, you want it queryable | Easy |
| **Path 2: Standalone MCP Server** | Developers / power users who want full control | Medium–Hard |

---

## Path 1: Register a Google Sheets Pattern Graph

This is the recommended path for most users. No code required.

### Step 1: Prepare your Sheet

Make sure your Sheet follows the Fodda Pattern Standard (4 tabs: Signals, Patterns, Entities, Graph Meta). See [Brief 1](brief-sheets-template.md) for the full spec.

**Minimum requirements:**
- At least 5 signals with summaries
- At least 2 patterns with descriptions
- Graph Meta tab filled in (graphName, graphSlug, description, creator at minimum)

### Step 2: Share with Fodda's service account

1. Open your Google Sheet
2. Click **Share**
3. Add this email as a **Viewer** (read-only):

```
fodda-sheets-reader@fodda-graphs.iam.gserviceaccount.com
```

> ⚠️ **Viewer only.** Fodda never writes to your Sheet. You maintain full ownership and control.

### Step 3: Register on Fodda

1. Go to **[app.fodda.ai](https://app.fodda.ai)**
2. Navigate to **My Graphs → Register New Graph**
3. Choose **"I have a Google Sheet"**
4. Paste your Google Sheet URL
5. Fodda reads your Sheet and confirms the structure is valid
6. Your graph is now live on the network

### Step 4: Get your MCP key

After registration, Fodda issues you an **MCP API key** — this is the URL you (and others) use to connect AI tools to your graph.

Your MCP URL will look like:

```
https://mcp.fodda.ai/mcp?api_key=sk_YOUR_KEY&user_id=USER_ID
```

**What to do with it:**
- Add it to **Claude** as a [Connector](https://claude.ai/customize/connectors)
- Add it to **Notion** when creating a new agent
- Share it with colleagues or clients who want to query your graph
- Keep it private if you want to control access

### Step 5: Provide information about your dataset

Fodda needs some context about your graph to help AI systems use it well. Most of this comes from your **Graph Meta** tab, but you may be asked to confirm or expand on:

| Field | What It's For | Example |
|-------|--------------|--------|
| `graphName` | Display name in the Fodda network | `Sarah's Clean Beauty Radar` |
| `graphSlug` | URL-safe identifier | `sarah-clean-beauty` |
| `description` | What your graph covers — this helps AI decide when to query it | `Innovation signals across clean beauty, sustainable packaging, and ingredient transparency` |
| `perspective` | Your editorial lens — what makes your graph unique | `Brand strategy perspective focused on Gen Z beauty consumers` |
| `sectors` | Which sectors your signals cover | `Beauty, Retail, Health` |
| `industries` | More specific industries | `Skincare, Fragrance, Supplements` |
| `geography` | Geographic coverage | `US, UK, Korea` |
| `updateFrequency` | How often you add new signals | `Weekly` |

> 💡 **The `description` and `perspective` fields are the most important.** They help AI systems decide whether to query your graph for a given question. A vague description means your graph gets skipped.

### What Happens Next

- Your graph appears in `list_graphs` for all Fodda MCP users
- AI assistants (Claude, Gemini, Cursor) can query your patterns and signals
- You can update your Sheet at any time — Fodda reads the latest data on each query
- Your graph is attributed to you (using the `creator` and `organization` from Graph Meta)

---

## Path 2: Register a Standalone MCP Server

This path is for developers who want more control — custom query logic, caching, or a data source that isn't Google Sheets. See [Advanced Brief: Standalone MCP Server](brief-standalone-mcp.md) for the full build guide.

### Step 1: Build and deploy your MCP server

Using the MCP SDK (`@modelcontextprotocol/sdk`), build a server that exposes tools like `search_patterns`, `get_signals`, `get_entities`, etc.

**Deployment options:**

| Platform | Difficulty | Cost |
|----------|-----------|------|
| Local (stdio) | Easy | Free — Claude Desktop only, not accessible remotely |
| Google Cloud Run | Medium | ~$0/month (free tier) |
| Vercel | Medium | Free tier — may have cold start issues |
| Cloudflare Workers | Hard | Free tier — needs runtime adaptation |

### Step 2: Register on Fodda

1. Go to **[app.fodda.ai](https://app.fodda.ai)** → **My Graphs → Register New Graph**
2. Choose **"I run my own MCP server"**
3. Enter your MCP endpoint URL (e.g., `https://my-graph.run.app/mcp`)
4. Fodda pings your server to verify it responds
5. Your graph appears in `list_graphs` for all Fodda MCP users

### Technical Notes

- Your graph doesn't need to match the core Trend + Article ontology exactly — partner graphs can use completely different schemas
- However, graphs work best when they map to **Pattern → Signal** at minimum
- Fodda's API captures user intent on registration (e.g., "Mainly Claude") to steer the setup UX

---

## Where Your Graph Shows Up

Once registered, your graph is queryable via:

### 1. Claude (via MCP Connector)

Users add the Fodda MCP URL as a Claude connector. When they ask questions, Claude can search your graph alongside other graphs in the network.

**Trial MCP URLs for testing:**

| Graph | URL |
|-------|-----|
| 🛒 Retail | `https://mcp.fodda.ai/mcp?api_key=sk_trial_retail&user_id=claude-user` |
| 💄 Beauty | `https://mcp.fodda.ai/mcp?api_key=sk_trial_beauty&user_id=claude-user` |
| ⚽ Sports | `https://mcp.fodda.ai/mcp?api_key=sk_trial_sports&user_id=claude-user` |

### 2. Notion (via Fodda Agent)

Users create a Notion agent that connects to Fodda. Your graph is available alongside all other graphs in the network.

**Trial MCP URLs for Notion:**

| Graph | URL |
|-------|-----|
| 🛒 Retail | `https://mcp.fodda.ai/mcp?api_key=sk_trial_retail&user_id=notion-user` |
| 💄 Beauty | `https://mcp.fodda.ai/mcp?api_key=sk_trial_beauty&user_id=notion-user` |
| ⚽ Sports | `https://mcp.fodda.ai/mcp?api_key=sk_trial_sports&user_id=notion-user` |

### 3. Any MCP-Compatible Tool

Cursor, Windsurf, Gemini, and any tool that supports the Model Context Protocol can connect to Fodda and query your graph.

---

## Monetization (Coming Soon)

Fodda is building **revenue-share for graph queries**. Contributors will earn based on how often their graph is queried through the network.

Details are coming soon — register now to be among the first contributors.

---

## FAQ

**Do I need to know how to code?**
No. Path 1 (Google Sheets) requires zero code. The briefs are designed for AI coding tools like Cursor and Claude — you describe what you want, the AI builds it.

**Where is my data stored?**
In YOUR Google Sheet. Fodda only reads it. You maintain full ownership and control.

**How does Fodda access my Sheet?**
You share it read-only with a Fodda service account. Fodda never modifies your Sheet.

**Can I update my data after registering?**
Yes. Update your Sheet at any time — Fodda reads the latest data on each query. No need to re-register.

**What if my graph uses a different structure?**
Partner graphs don't need to match the core ontology exactly. But graphs work best when they map to Pattern → Signal at minimum.

---

## The Full Journey

| Step | Brief | Status |
|------|-------|--------|
| Set up your Google Sheet | [Brief 1: Sheets Template](brief-sheets-template.md) | ✅ |
| Collect signals + recognize patterns | [Brief 2: Signal Collector](brief-signal-collector.md) | ✅ |
| **Publish to the Fodda network** | **Brief 3: This document** | 👈 You are here |
| Build your own MCP server (optional) | [Advanced: Standalone MCP Server](brief-standalone-mcp.md) | For power users |

---

*Fodda Pattern Network · [fodda.ai](https://www.fodda.ai) · March 2026*