Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
158 commits
Select commit Hold shift + click to select a range
d6241c9
remove references to dataclass objects
kmoscoe Jun 12, 2025
101c5fd
Fix a copy-paste error.
kmoscoe Jun 12, 2025
504d852
remove extra file
kmoscoe Jun 12, 2025
1697b22
Merge branch 'datacommonsorg:master' into master
kmoscoe Jun 12, 2025
426a81c
Merge branch 'master' of https://github.com/datacommonsorg/docsite
kmoscoe Jun 24, 2025
a40c7c8
Merge branch 'master' of https://github.com/kmoscoe/docsite
kmoscoe Jun 24, 2025
4c69c15
Merge branch 'datacommonsorg:master' into master
kmoscoe Sep 17, 2025
156cff0
Create placeholders for LLM pages
kmoscoe Sep 23, 2025
a975d24
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Sep 23, 2025
e3883e3
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Sep 23, 2025
a4e40a4
rename to MCP
kmoscoe Sep 23, 2025
1fbd187
complete rename
kmoscoe Sep 23, 2025
82228b1
remove old file
kmoscoe Sep 23, 2025
e656552
Changes from Keyur
kmoscoe Sep 23, 2025
9101325
Add target tag
kmoscoe Sep 23, 2025
d003cc1
Rewording suggested by Keyur
kmoscoe Sep 23, 2025
6b94948
Remove extraneous text
kmoscoe Sep 23, 2025
2ecd2bf
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Oct 15, 2025
4b26adc
Fix a copy-paste error.
kmoscoe Jun 12, 2025
7d15bbe
Migrate MCP docs to docsite
kmoscoe Oct 15, 2025
f481c40
Restructuring
kmoscoe Oct 15, 2025
5d70c4a
Remove unused file
kmoscoe Oct 15, 2025
b241392
Add TOCs etc.
kmoscoe Oct 15, 2025
f78ccd3
Update var formatting
kmoscoe Oct 15, 2025
923f7c5
comments from Keyur
kmoscoe Oct 16, 2025
7ec3018
another change from Keyur
kmoscoe Oct 16, 2025
3fe9f4f
Update mcp/index.md
kmoscoe Oct 16, 2025
93db32f
Changes from Christie
kmoscoe Oct 16, 2025
5cd3a31
Apply suggestion from @clincoln8
kmoscoe Oct 16, 2025
655aece
More changes from Christie
kmoscoe Oct 16, 2025
1944f14
Changes from Dan
kmoscoe Oct 20, 2025
21d43ee
Link fixes
kmoscoe Oct 20, 2025
ab810ea
Remove MCP inspector info
kmoscoe Oct 21, 2025
7f8521f
Add more context to agent dev doc
kmoscoe Oct 21, 2025
4f880c1
fix formatting
kmoscoe Oct 21, 2025
cff1ac7
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Oct 24, 2025
3bef318
Create placeholders for LLM pages
kmoscoe Sep 23, 2025
74a7ab2
merge
kmoscoe Oct 24, 2025
1b768e9
Slight rewording based on comment from Christie
kmoscoe Oct 24, 2025
4047f23
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Oct 27, 2025
c22bdba
Lots of restructuring
kmoscoe Oct 29, 2025
5faf6ef
More work on Gemini CLI extension
kmoscoe Nov 3, 2025
432bbb9
More changes
kmoscoe Nov 3, 2025
1154f25
more changes
kmoscoe Nov 3, 2025
ece8882
more changes
kmoscoe Nov 3, 2025
d695244
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Nov 3, 2025
764ea9f
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Nov 3, 2025
f81946b
Update mcp/run_tools.md
kmoscoe Nov 3, 2025
1fb1640
implement suggestions from Christie
kmoscoe Nov 3, 2025
c5fd5fe
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Nov 3, 2025
90ddfc3
Add some bullets to comparison section
kmoscoe Nov 3, 2025
a9ad87f
Fix update section
kmoscoe Nov 3, 2025
4930a5b
rename "prompt" to "context"
kmoscoe Nov 4, 2025
bb278f8
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Nov 11, 2025
9fa9f0f
add mention of Gemini CLI extension for custom DC
kmoscoe Nov 12, 2025
c3edbe0
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Nov 12, 2025
977ea45
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Nov 12, 2025
6c2bd5c
Update custom DC vars procedure
kmoscoe Nov 17, 2025
4d67fc6
Remove reference to .env file in extension run
kmoscoe Nov 21, 2025
9a34f12
Merge branch 'master' into mcp
kmoscoe Nov 21, 2025
2bb5ca3
slight fix
kmoscoe Nov 24, 2025
e3a7193
Add section on creating a custom extension
kmoscoe Nov 24, 2025
25cad3a
Some rewording
kmoscoe Nov 25, 2025
7c71b3a
Fix formatting
kmoscoe Nov 25, 2025
8dd7f75
More revisions and edits
kmoscoe Nov 25, 2025
9ea74cd
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Nov 25, 2025
9f58ec3
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Nov 25, 2025
ab6fb59
Remove file from other branch
kmoscoe Nov 25, 2025
9bc3f7f
minor edits
kmoscoe Nov 25, 2025
2fac33b
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Nov 25, 2025
ff33361
Merge branch 'master' into mcp
kmoscoe Dec 2, 2025
45e8a57
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Dec 3, 2025
f99cd81
Add Windows command
kmoscoe Dec 3, 2025
482c650
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Dec 3, 2025
fdeea2e
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Dec 3, 2025
5a6fb16
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Dec 9, 2025
0323953
Add warning about nvm
kmoscoe Dec 9, 2025
5f9dcca
Remove warning
kmoscoe Dec 9, 2025
b5ddb9c
Remove reference to node.js
kmoscoe Dec 9, 2025
c09b44c
Update mcp/run_tools.md
kmoscoe Dec 9, 2025
9f9a9bd
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Dec 16, 2025
6bb745c
Add required header to connect to a remote server
kmoscoe Dec 17, 2025
7ededf3
Add additional accept type
kmoscoe Dec 17, 2025
1550ed8
Add code for sample agent headers
kmoscoe Dec 17, 2025
75f5150
Apply suggestion from @gemini-code-assist[bot]
kmoscoe Dec 17, 2025
6395a67
Remove headers from basic agent
kmoscoe Dec 17, 2025
fe34778
Merge branch 'datacommonsorg:master' into mcp
kmoscoe Dec 17, 2025
0ca77f9
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Dec 17, 2025
1c114f1
Revert last change
kmoscoe Dec 17, 2025
4db9a2c
Start of deploying MCP server to GCP
kmoscoe Dec 30, 2025
98b3265
Complete rewrite of hosting MCP server content
kmoscoe Jan 7, 2026
2073fdb
more changes
kmoscoe Jan 8, 2026
c5f95b0
More changes
kmoscoe Jan 12, 2026
32bacd9
formatting fixes
kmoscoe Jan 12, 2026
44395c9
add reference to custom DC doc
kmoscoe Jan 12, 2026
c131f42
HTML fix
kmoscoe Jan 12, 2026
5640448
Update custom_dc/mcp_server_cloud.md
kmoscoe Jan 12, 2026
cfd71ad
Update custom_dc/mcp_server_cloud.md
kmoscoe Jan 12, 2026
6eabd20
Remove a redundant step
kmoscoe Jan 12, 2026
5a8511e
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Jan 12, 2026
97a8139
Merge changes from Code Assist
kmoscoe Jan 12, 2026
1f3d4c3
Remove specifics of scaling etc. and refer to Cloud Run docs instead
kmoscoe Jan 12, 2026
0d8a04b
rename file
kmoscoe Jan 13, 2026
887f81e
Fix broken link
kmoscoe Jan 13, 2026
b185be5
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Jan 13, 2026
fd1356b
First round of changes for hosted MCP server
kmoscoe Jan 13, 2026
4593a3f
more changes
kmoscoe Jan 13, 2026
63fc208
First set of changes to run_tools file
kmoscoe Jan 13, 2026
b982f47
start of changes to custom DC docs
kmoscoe Jan 13, 2026
9fc7d41
More restructuring and file name change
kmoscoe Jan 14, 2026
59b01f4
More restructuring and expansion of custom DC doc
kmoscoe Jan 14, 2026
ca48c96
Restructure: move sample agent to separat page, and move local proced…
kmoscoe Jan 14, 2026
73f2d57
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Jan 14, 2026
dc6e212
Remove develop agent page and consolidate all self-hosted instruction…
kmoscoe Jan 14, 2026
f4988b2
More changes for hosted MCP
kmoscoe Jan 14, 2026
2c8351d
complete first draft of hosted MCP changes
kmoscoe Jan 20, 2026
1f02ad7
Update mcp/run_tools.md
kmoscoe Jan 20, 2026
3c634d8
Update mcp/run_tools.md
kmoscoe Jan 20, 2026
db863a1
Update mcp/run_tools.md
kmoscoe Jan 20, 2026
17f8a86
Update custom_dc/run_mcp_tools.md
kmoscoe Jan 20, 2026
0108a4b
fix grammatical errors
kmoscoe Jan 20, 2026
71496d4
minor changes
kmoscoe Jan 20, 2026
4d47452
minor changes
kmoscoe Jan 20, 2026
a91fbd9
minor fix
kmoscoe Jan 20, 2026
07e0282
Add way of setting the API key literally in settings.json
kmoscoe Jan 20, 2026
d1ead01
added tip about Gemini CLI env var
kmoscoe Jan 20, 2026
3b43807
Add another way of using the key in standalone mode
kmoscoe Jan 20, 2026
ba7f0b9
Rename custom DC file
kmoscoe Jan 27, 2026
2030013
Add MCP to API key reqs
kmoscoe Jan 28, 2026
40c0a9c
Merge branch 'master' into mcp
kmoscoe Feb 2, 2026
ae9df7e
Fix broken link
kmoscoe Feb 2, 2026
bef4af1
update stable release date
kmoscoe Feb 2, 2026
582a430
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Feb 2, 2026
5ec052e
markdown fix
kmoscoe Feb 3, 2026
c4bd5b9
Incorporate feedback from Carolyn
kmoscoe Feb 3, 2026
bc31b9c
Update graphic
kmoscoe Feb 3, 2026
750711a
Fix broken link
kmoscoe Feb 3, 2026
63d12c7
Removed references to custom DC
kmoscoe Feb 3, 2026
d9cab13
Update custom_dc/run_mcp_tools.md
kmoscoe Feb 4, 2026
15bd390
Update custom_dc/run_mcp_tools.md
kmoscoe Feb 4, 2026
8df11f4
Incorporate suggestions from Christie
kmoscoe Feb 4, 2026
d5c2e61
Merge branch 'master' of https://github.com/datacommonsorg/docsite in…
kmoscoe Feb 10, 2026
c23835b
Start work on bundled MCP server
kmoscoe Feb 11, 2026
e992dea
more work on bundled MCP server
kmoscoe Feb 11, 2026
52f4115
More work on bundled MCP
kmoscoe Feb 12, 2026
7e59ed7
Formatting fixes
kmoscoe Feb 12, 2026
1e3d4ba
more formatting fixes
kmoscoe Feb 12, 2026
3fd925c
Link fixes, reorder nav
kmoscoe Feb 12, 2026
c96627d
tiny formatting fix
kmoscoe Feb 12, 2026
f79ccdb
Apply suggestion from @gemini-code-assist[bot]
kmoscoe Feb 12, 2026
35c223c
Apply suggestion from @gemini-code-assist[bot]
kmoscoe Feb 12, 2026
4aed035
Apply suggestion from @gemini-code-assist[bot]
kmoscoe Feb 12, 2026
15f0e62
Update mcp/host_server.md
kmoscoe Feb 12, 2026
79161e3
Fixes from Keyur
kmoscoe Feb 12, 2026
c660d89
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Feb 12, 2026
62957c9
Put in links for prebuilt images
kmoscoe Feb 12, 2026
adf99b9
Merge branch 'mcp' of https://github.com/kmoscoe/docsite into mcp
kmoscoe Feb 12, 2026
67a3529
fix busted merge
kmoscoe Feb 12, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions custom_dc/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ This is step 1 of the [recommended workflow](/custom_dc/index.html#workflow).
* TOC
{:toc}

{: #overview}
## System overview

The instructions in this page use the following setup:
Expand Down
9 changes: 4 additions & 5 deletions mcp/host_server.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ To instruct Gemini CLI to start up a local server using Stdio, replace the `data

<pre>
{
// ...
...
"mcpServers": {
"datacommons-mcp": {
"command": "uvx",
Expand All @@ -50,7 +50,7 @@ To instruct Gemini CLI to start up a local server using Stdio, replace the `data
"env": "<var>YOUR DC API KEY</var>"
}
}
// ...
...
}
</pre>

Expand Down Expand Up @@ -127,13 +127,12 @@ The server is addressable with the endpoint `mcp`. For example, `http://my-mcp-s
#### Sample agent

1. Modify [`basic_agent/agent.py`](https://github.com/datacommonsorg/agent-toolkit/blob/main/packages/datacommons-mcp/examples/sample_agents/basic_agent/agent.py){: target="_blank"} as follows:

<pre>
from google.adk.tools.mcp_tool.mcp_toolset import (
MCPToolset,
StreamableHTTPConnectionParams
)
...
#...
root_agent = LlmAgent(
# ...
tools=[McpToolset(
Expand All @@ -146,7 +145,7 @@ The server is addressable with the endpoint `mcp`. For example, `http://my-mcp-s
)
],
)
</pre>
</pre>
1. Customize the agent as desired, as described in [Customize the agent](run_tools.md#customize-agent).
1. [Run the startup commands](run_tools.md#run-sample) as usual.

Expand Down
5 changes: 3 additions & 2 deletions mcp/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,9 @@ For base Data Commons, the server is available as a hosted managed deployment to
![base Data Commons](/assets/images/mcp1.png)

You can also run your own MCP server locally, or in Google Cloud Platform. If you want to use the server to query a Custom Data Commons instance, you _must_ run your own. The server is available as:
- A prebuilt Python package for running locally
- A prebuilt Docker image for running in a Google Cloud Run service
- A prebuilt [Python package](https://pypi.org/project/datacommons-mcp/){: target="_blank"} for running locally
- A prebuilt standalone [Docker image](https://console.cloud.google.com/artifacts/docker/datcom-ci/us/gcr.io/datacommons-mcp-server?project=datcom-ci){: target="_blank"} for running in a cloud service
- Bundled with the [Custom Data Commons Docker services image](/custom_dc/quickstart.html#overview) for running in Google Cloud Run (for Custom Data Commons only)

![base or Custom Data Commons](/assets/images/mcp2.png)

Expand Down
4 changes: 2 additions & 2 deletions mcp/run_tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ In addition to the Data Commons API key, you must install the following:
To configure Gemini CLI to connect to the Data Commons server, edit the relevant `settings.json` file (e.g. `~/.gemini/settings.json`) to add the following:
<pre>
{
// ...
...
"mcpServers": {
"datacommons-mcp": {
"httpUrl": "https://api.datacommons.org/mcp",
Expand All @@ -166,7 +166,7 @@ To configure Gemini CLI to connect to the Data Commons server, edit the relevant
}
}
}
// ...
...
}
</pre>

Expand Down
Loading