Skip to main content

​
Overview

Goose (Block’s autonomous developer agent) now supports direct remote HTTP endpoints for connecting to Civic MCP servers with full OAuth2 support.

​
Prerequisites

Goose

Install Goose autonomous developer agent

Civic Account

Create a free account on nexus.civic.com

​
Setup with Remote HTTP Endpoint

1

Get your MCP URL

  1. Sign in to nexus.civic.com
  2. Select the MCP servers you want to use
  3. Copy the MCP URL: https://nexus.civic.com/hub/mcp
2

Configure Goose

Add the Civic MCP server to your Goose configuration:
  1. Open your Goose configuration file (typically ~/.config/goose/config.yaml or project-specific .goose/config.yaml)
  2. Add the following MCP server configuration:
mcp:
  servers:
    civic:
      type: http
      url: https://nexus.civic.com/hub/mcp
      name: "Civic"
Goose supports HTTP endpoints directly, no local bridge required.
3

Restart Goose

Restart Goose to load the new configuration:
goose restart
Or if running as a service:
goose stop
goose start
4

Test Connection

Verify the connection is working:
"What MCP servers are available?"
"Show me my connected tools"
Goose should respond with the list of available Civic tools.
5

Authenticate Services

When you first use a tool that requires authentication:
  1. Goose will prompt you to authorize access
  2. A browser window will open for OAuth authentication
  3. Sign in to the service and authorize access
  4. Return to Goose when complete
Authentication is handled securely by Civic. Your credentials are never exposed to Goose or stored locally.

​
Alternative: Hub Bridge Setup

If you prefer to use the local Hub Bridge instead of direct HTTP endpoints:
1

Configure Hub Bridge

Add this to your Goose configuration:
mcp:
  servers:
    civic:
      type: stdio
      command: npx
      args: ["-y", "@civic/hub-bridge"]
2

Install Node.js

Make sure Node.js 18+ is installed for the Hub Bridge to work
3

Restart and Test

Restart Goose and test with: “What MCP servers are available?”

​
Resources

Client Compatibility

Goose MCP support details (Remote URL method)

Claude Desktop Guide

Similar Remote URL setup process

Troubleshooting

Common connection issues

Get Help

Join our developer community for Goose setup help